기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Location Service에 대한 AWS 통합
Amazon Location Service는 효율적인 인증, 모니터링, 관리 및 개발을 위해 다양한 AWS 서비스와 통합됩니다.
**모니터링**
+ **Amazon CloudWatch** – 요청, 지연 시간, 장애 및 로그를 포함하여 서비스 사용 및 상태에 대한 지표를 볼 수 있습니다. 자세한 내용은 [Amazon CloudWatch를 사용하여 모니터링](cloudwatch.md) 섹션을 참조하세요.
+ **AWS CloudTrail** – 사용자, 역할 또는 AWS 서비스가 수행한 작업을 포함한 API 호출을 기록하고 모니터링합니다. 자세한 내용은 [를 사용하여 모니터링 및 로깅 AWS CloudTrail](cloudtrail.md) 섹션을 참조하세요.
**관리**
+ **AWS CloudFormation** – Amazon Location은 리소스 및 인프라를 생성하고 관리하는 데 소요되는 시간을 줄일 수 있도록 AWS 리소스를 모델링하고 설정하는 데 도움이 되는 서비스인 AWS CloudFormation과 통합됩니다. 자세한 내용은 [를 사용하여 리소스 생성 AWS CloudFormation](cloudformation.md) 섹션을 참조하세요.
+ **Service Quotas** - Service Quotas 콘솔 및 AWS CLI를 사용하여 조정 가능한 할당량에 대한 변경을 요청합니다. 자세한 내용은 [Service Quotas를 사용하여 할당량 관리](manage-quotas.md) 섹션을 참조하세요.
+ **태그** – Amazon Location에서 리소스 태그 지정 기능을 사용하여 목적, 소유자, 환경 또는 기준에 따라 리소스를 분류하는 태그를 생성할 수 있습니다. 리소스에 태그를 지정하면 리소스를 관리, 식별, 정리, 검색 및 필터링하는 데 도움이 됩니다. 자세한 내용은 [태그를 사용하여 리소스 관리](manage-resources.md) 섹션을 참조하세요.
**인증**
+ **Amazon Cognito** – 프론트엔드 SDK와 직접 HTTPS 요청 모두에서 AWS Identity and Access Management(IAM)을 직접 사용하는 대신 Amazon Cognito 인증을 사용할 수 있습니다. 자세한 내용은 [Amazon Cognito를 사용하여 인증](authenticating-using-cognito.md) 섹션을 참조하세요.
+ **IAM** – AWS Identity and Access Management(IAM)은 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어할 수 있도록 지원하는 AWS 서비스입니다. IAM 관리자는 어떤 사용자가 Amazon Location Service 리소스를 사용할 수 있도록 인증(로그인)되고 권한이 부여(권한 있음)될 수 있는지 제어합니다. 자세한 내용은 [AWS Identity and Access Management 를 사용하여 인증](security-iam.md) 섹션을 참조하세요.
**값 추가됨**
+ **Amazon EventBridge** – AWS Lambda 기능을 사용하여 애플리케이션의 다른 부분과 워크플로를 활성화할 수 있도록 이벤트 기반 애플리케이션 아키텍처를 지원합니다. 자세한 내용은 [Amazon EventBridge를 사용하여 Amazon Location Service 이벤트에 대응하기](location-events.md) 섹션을 참조하세요.
+ **AWS IoT** – AWS IoT Core 규칙 엔진은 디바이스의 메시지 주제에 대한 쿼리를 저장하고, Amazon Location Service와 같은 다른 AWS 서비스에 메시지를 보내기 위한 작업을 정의할 수 있도록 지원합니다. 자신의 위치를 좌표로 인식하는 디바이스는 규칙 엔진을 통해 Amazon Location으로 위치를 전달할 수 있습니다. 자세한 내용은 [Amazon Location Service에서 AWS IoT와 MQTT를 사용한 추적](tracking-using-mqtt.md) 섹션을 참조하세요.
**개발자 도구**
+ **SDK** – Amazon Location Service는 개발자가 위치 지원 애플리케이션을 구축할 수 있는 다양한 도구를 제공합니다. 여기에는 표준 AWS SDK, 모바일 및 웹 SDK가 포함됩니다. 자세한 내용은 [Amazon Location Service를 위한 SDK 및 프레임워크](dev-sdks.md) 섹션을 참조하세요.
+ **AWS CLI** – AWS Command Line Interface(AWS CLI)는 명령줄 셸의 명령을 사용하여 AWS 서비스와 상호 작용할 수 있는 오픈 소스 도구입니다. 최소 구성을 사용합니다. 자세한 내용은 [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/location/)를 참조하거나, [AWS CLI](https://docs.aws.amazon.com/cli/)에 대해 자세히 알아보세요.
+ **샘플 코드** - 샘플 코드는 AWS SDK, 모바일 및 웹 SDK, MapLibre를 사용하여 Amazon Location을 사용하는 방법을 보여줍니다. 자세한 내용은 [샘플](https://location.aws.com/samples)을 참조하세요.
+ **Amazon Location Service 콘솔** – Amazon Location 콘솔을 사용하여 API, 리소스에 대해 알아보고 시각적인 대화형 학습 도구를 사용해 보세요. 자세한 내용은 [Amazon Location Service 콘솔](https://console.aws.amazon.com/location/explore/home)을 참조하세요.
**비용 및 결제**
+ **AWS 결제 및 비용 관리** - 이 서비스는 청구서를 결제하고 비용을 최적화하는 데 도움이 됩니다. Amazon Web Services는 사용량에 따라 계정에 요금을 청구하므로 사용한 만큼만 비용을 지불하면 됩니다. 자세한 내용은 [요금 모델](pricing.md) 또는 [Billing and Cost Management를 사용하여 AWS 결제 및 비용 관리](manage-billing.md) 섹션을 참조하세요.
# 리소스 관리
리소스 관리는 AWS CloudFormation을 사용하여 할당량을 관리하고, 태그를 사용하여 리소스를 구성하고, 비용을 제어하고, 리소스 생성을 자동화하는 도구와 프로세스를 제공합니다. 이러한 기능을 사용하면 Amazon Location 내에서 리소스를 효율적으로 할당, 모니터링 및 관리할 수 있습니다.
이러한 도구를 사용하면 서비스 제한을 설정하고, 더 나은 조직을 위해 리소스에 태그를 지정하고, 비용을 모니터링하고, CloudFormation에서 코드형 인프라를 사용하여 프로그래밍 방식으로 리소스를 생성하고 관리하여 운영 효율성을 유지할 수 있습니다.
**Topics**
+ [Service Quotas를 사용하여 할당량 관리](manage-quotas.md)
+ [태그를 사용하여 리소스 관리](manage-resources.md)
+ [Billing and Cost Management를 사용하여 AWS 결제 및 비용 관리](manage-billing.md)
+ [를 사용하여 리소스 생성 AWS CloudFormation](cloudformation.md)
# Service Quotas를 사용하여 할당량 관리
Service Quotas 콘솔을 사용하면 조정 가능한 [할당량에 대한 할당량 증가 또는 감소를 요청할](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) 수 있습니다. 서비스 할당량은 AWS 계정 및 AWS 리전당 보유할 수 있는 최대 API 호출 또는 리소스 수입니다. 할당량 증가를 요청할 때 대부분의 할당량은 리전별로 다르므로 할당량 증가가 필요한 리전을 선택합니다. Amazon Location Service는 서비스 할당량을 초과하는 추가 요청을 거부합니다.
요율 한도(… 요율로 시작하는 할당량)는 초당 최대 요청 수로, 버스트 비율은 각 API 작업에 대해 정의된 초당 한도의 80%입니다. Service Quotas를 통해 계정에 대해 속도 제한이 증가한 작업은 증가된 속도 제한의 80%보다 낮은 버스트 속도를 가질 수 있습니다. Amazon Location Service는 작업 속도 제한을 초과하는 요청을 제한합니다.
## Amazon Location Service 할당량 관리
Amazon Location Service는 중앙 위치에서 할당량을 보고 관리할 수 있는 AWS 서비스인 Service Quotas와 통합됩니다. 자세한 내용은 *Service Quotas 사용 설명서*의 [Service Quotas는 무엇인가요?](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)를 참조하세요.
Service Quotas를 사용하면 모든 Amazon Location Service 할당량의 값을 쉽게 찾을 수 있습니다.
------
#### [ AWS Management Console ]
1. [Service Quotas 콘솔](https://console.aws.amazon.com/servicequotas)을 엽니다.
1. 탐색 창에서 **AWS 서비스**를 선택합니다.
1. **AWS 서비스** 목록에서 **Amazon Location**을 검색하여 선택합니다.
1. **서비스 할당량** 목록에서 서비스 할당량 이름, 적용된 값(사용 가능한 경우), AWS 기본 할당량 및 할당량 값을 조정할 수 있는지 여부를 확인할 수 있습니다.
1. 설명 등 서비스 할당량에 대한 추가 정보를 보려면 할당량 이름을 선택합니다.
1. (선택 사항) 할당량 증가를 요청하려면 증가시킬 할당량을 선택하고 **할당량 증가 요청**을 선택한 다음, 필요한 정보를 입력하거나 선택하고 **요청**을 선택합니다.
콘솔을 사용하여 서비스 할당량에 대한 추가 작업을 수행하려면 *Service Quotas 사용 설명서*를 참조하세요. 할당량 증가를 요청하려면 *Service Quotas 사용 설명서*의 [할당량 증가 요청](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)을 참조하세요.
------
#### [ AWS CLI ]
다음 명령을 실행하여 기본 Amazon Location 할당량을 확인합니다.
```
aws service-quotas list-aws-default-service-quotas \
--query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \
--service-code geo \
--output table
```
를 사용하여 서비스 할당량에 대해 자세히 알아보려면 *AWS CLI 명령* AWS CLI참조의 Service Quotas 섹션을 참조하세요. 할당량 증가를 요청하려면 *AWS CLI 명령 참조*에서 [https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html)를 참조하세요.
------
## FAQ
**Amazon Location Service 리소스의 기본 할당량은 무엇입니까?**
Amazon Location Service는 서비스 용량을 관리하는 데 도움이 되도록 API의 기본 할당량을 설정합니다. 이 할당량은 [AWS Service Quotas 관리 콘솔](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)에서 확인할 수 있습니다. 아래 [Amazon Location Service 할당량 모니터링](#manage-quotas_monitor) 섹션에서 모든 항목에 대한 링크를 찾을 수 있습니다.
**Amazon Location Service에 대한 할당량 증가를 요청하려면 어떻게 해야 합니까?**
[셀프 서비스 콘솔](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)을 통해 각 API의 기본 한도의 최대 2배까지 Amazon Location Service 할당량 증가를 요청할 수 있습니다. 할당량이 기본 한도의 2배를 초과하는 경우 셀프 서비스 콘솔에서 요청하면 지원 티켓이 제출됩니다. 또는 프리미엄 지원 팀을 연결할 수도 있습니다.
**Amazon Location Service에 대한 더 높은 할당량 요청과 관련된 추가 비용이 있습니까?**
할당량 증가 요청에 대한 직접 요금은 없지만 사용량 수준이 높을수록 소비되는 추가 리소스에 따라 서비스 비용이 증가할 수 있습니다.
## Amazon Location Service 할당량 모니터링
Amazon CloudWatch를 사용하면 할당량 대비 사용량을 모니터링할 수 있습니다. 자세한 내용은 [Amazon CloudWatch를 사용하여 모니터링](cloudwatch.md) 단원을 참조하십시오.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/location/latest/developerguide/manage-quotas.html)
## 자세히 알아보기
서비스 할당량에 대한 자세한 내용은 [Service Quotas 설명서](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)를 참조하세요.
# 태그를 사용하여 리소스 관리
Amazon Location에서 리소스 태그 지정 기능을 사용하여 목적, 소유자, 환경 또는 기준에 따라 리소스를 분류할 수 있습니다. 리소스에 태그를 지정하면 리소스를 관리, 식별, 정리, 검색 및 필터링하는 데 도움이 됩니다. 예를 들어 AWS Resource Groups를 사용하면 하나 이상의 태그 또는 태그 일부를 기반으로 AWS 리소스 그룹을 생성할 수 있습니다. 또한 AWS CloudFormation 스택의 발생에 따라 그룹을 생성할 수도 있습니다. 리소스 그룹 및 Tag Editor를 사용하면 여러 서비스, 리소스 및 리전으로 구성된 애플리케이션의 데이터를 한 곳에 통합하여 볼 수 있습니다. [일반적인 태그 지정 전략](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html)에 대한 자세한 내용은 *AWS 일반 참조*를 참조하세요.
각 태그는 사용자가 정의하는 키와 값으로 구성되는 레이블입니다.
+ **태그 키** – 태그 값을 분류하는 일반적인 레이블입니다. 예를 들어 `CostCenter`입니다.
+ **태그 값** – 태그 키 카테고리에 대한 선택적 설명입니다. 예를 들어 `MobileAssetTrackingResourcesProd`입니다.
이 주제는 태그 지정 제한을 검토하여 태그 지정을 시작할 수 있도록 도와줍니다. 또한 비용 할당 보고서를 사용하여 태그를 생성하고 태그를 사용하여 각 활성 태그의 AWS 비용을 추적하는 방법을 보여줍니다.
해당 내용은 다음을 참조하세요.
+ 태그 지정 모범 사례는 *AWS 일반* 참조의 [AWS 리소스 태그 지정](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html)을 참조하세요.
+ 태그를 사용하여 AWS 리소스에 대한 액세스를 제어하려면 *AWS Identity and Access Management 사용 설명서*의 [태그를 사용하여 AWS 리소스에 대한 액세스 제어를](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) 참조하세요.
## 제한 사항
**참고**
태그 키가 기존 태그와 동일한 새 태그를 추가하는 경우 새 태그가 기존 태그를 덮어씁니다.
태그를 지정하면 리소스를 보다 효과적으로 구성하고 관리할 수 있습니다. 이 페이지에서는 Amazon Location Service 내에서 태그 사용을 관리하는 특정 규칙 및 제약 조건을 간략하게 설명합니다. 이러한 태그 지정 제한을 이해하면 모범 사례를 준수하고 위치 기반 리소스 및 애플리케이션에 태그 지정 전략을 구현할 때 발생할 수 있는 문제를 방지할 수 있습니다.
태그에 적용되는 기본 제한 사항은 다음과 같습니다.
+ 리소스당 최대 태그: 50개
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이: 유니코드 문자 128자(UTF-8)
+ 최대 값 길이: 유니코드 문자 256자(UTF-8)
+ 서비스에서 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 특수 문자 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대/소문자를 구분합니다.
+ `aws:` 접두사는 AWS 사용을 위해 예약되어 있습니다. 태그에 이 접두사가 있는 태그 키가 있는 경우 태그의 키 또는 값을 편집하거나 삭제할 수 없습니다. aws: 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.
## 리소스에 태그를 지정할 수 있는 권한 부여
IAM 정책을 사용하여 Amazon Location 리소스에 대한 액세스를 제어하고 생성 시 리소스에 태그를 지정할 수 있는 권한을 부여할 수 있습니다. 리소스 생성 권한을 부여하는 것 외에도 정책에는 태그 지정 작업을 허용하는 작업 권한이 포함될 수 있습니다.
+ `geo:TagResource` – 사용자가 지정된 Amazon Location 리소스에 하나 이상의 태그를 할당할 수 있습니다.
+ `geo:UntagResource` – 사용자가 지정된 Amazon Location 리소스에서 하나 이상의 태그를 제거할 수 있습니다.
+ `geo:ListTagsForResource` – 사용자가 Amazon Location 리소스에 할당된 모든 태그를 나열할 수 있습니다.
다음은 사용자가 지오펜스 컬렉션을 생성하고 리소스에 태그를 지정할 수 있도록 허용하는 정책 예입니다.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowTaggingForGeofenceCollectionOnCreation",
"Effect": "Allow",
"Action": [
"geo:CreateGeofenceCollection",
"geo:TagResource"
],
"Resource": "arn:aws:geo:region:accountID:geofence-collection/*"
]
}
```
## 리소스에 태그 추가
Amazon Location 콘솔, AWS CLI 또는 Amazon Location APIs
+ [지오펜스 컬렉션 리소스 관리](managing-geofence-collections.md)
+ [트래커 생성](start-create-tracker.md)
**기존 리소스에 태그를 지정하려면 태그를 편집하거나 삭제하세요.**
1. [Amazon Location 콘솔](https://console.aws.amazon.com/location)을 엽니다.
1. 왼쪽 탐색 창에서 태그를 지정하려는 리소스를 선택합니다. 예를 들어 **맵**이 있습니다.
1. 목록에서 리소스를 선택합니다.
1. **태그 관리**를 선택하여 태그를 추가, 편집 또는 삭제합니다.
## 태그 사용 방법
비용 할당에 태그를 사용하여 AWS 비용을 자세히 추적할 수 있습니다. 비용 할당 태그를 활성화한 후는 비용 할당 태그를 AWS 사용하여 비용 할당 보고서에서 리소스 결제를 구성합니다. 이를 통해 사용 비용을 분류하고 추적할 수 있습니다.
Amazon Location은 [사용자 정의](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html) - 태그를 지원합니다. 이러한 태그는 사용자가 생성한 사용자 지정 태그입니다. 사용자 정의 태그에는 `user:` 접두사(예: `user:CostCenter`)를 사용합니다.
각 태그 유형을 개별적으로 활성화해야 합니다. 태그가 활성화되면 [AWS Cost Explorer를 활성화](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html)하거나 월별 비용 할당 보고서를 볼 수 있습니다.
**사용자 정의된 태그 활성화 방법**
1. [Billing and Cost Management 콘솔](https://console.aws.amazon.com/billing)을 엽니다.
1. 왼쪽 탐색 창에서 **비용 할당 태그**를 선택합니다.
1. **사용자 정의 비용 할당 태그** 탭에서 활성화하려는 태그 키를 선택합니다.
1. **활성화**를 선택합니다.
태그를 활성화하면가 리소스 사용량 및 비용에 대한 [월별 비용 할당 보고서를](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) AWS 생성합니다. 이 비용 할당 보고서에는 태그가 지정된 리소스와 태그가 지정되지 않은 리소스를 포함하여 각 결제 기간의 모든 AWS 비용이 포함됩니다. 자세한 내용은 *AWS 결제 사용 설명서*의 [비용 할당 태그를 사용하여 AWS 비용 구성 및 추적](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.
### 태그를 사용한 리소스 액세스 제어
AWS Identity and Access Management (IAM) 정책은 태그 기반 조건을 지원하므로 특정 태그 키 및 값을 기반으로 리소스에 대한 권한 부여를 관리할 수 있습니다. 예를 들어 IAM 역할 정책에는 태그를 기반으로 개발, 테스트, 프로덕션 등 특정 환경에 대한 액세스를 제한하는 조건이 포함될 수 있습니다. 자세한 내용은 [태그 기반 리소스 액세스 제어](https://docs.aws.amazon.com/location/latest/developerguide/security-iam.html#security_iam_id-based-policy-examples)의 항목을 참조하세요.
# Billing and Cost Management를 사용하여 AWS 결제 및 비용 관리
AWS Billing and Cost Management는 청구서를 결제하고 비용을 최적화하는 데 도움이 되는 기능을 제공하는 웹 서비스입니다. Amazon Web Services는 사용량에 따라 계정에 요금을 청구하므로 사용한 만큼만 비용을 지불하면 됩니다.
**청구서를 확인하고 비용을 관리하는 방법**
1. 에서 [Billing and Cost Management](https://console.aws.amazon.com/billing)를 엽니다 AWS Management Console.
1. 서비스별 Amazon Web Services, Inc. 요금에서 위치 서비스 검색
1. **[\$1] 위치 서비스** 선택
1. **[\$1] 리전 이름** 선택
자세한 내용은 AWS Management Console에서 [Billing and Cost Management](https://console.aws.amazon.com/costmanagement/home#/getting-started)를 참조하세요.
# 를 사용하여 리소스 생성 AWS CloudFormation
Amazon Location Service는 AWS 리소스 및 인프라를 생성하고 관리하는 데 소요되는 시간을 줄일 수 있도록 리소스를 모델링하고 설정하는 데 도움이 되는 CloudFormation서비스와 통합됩니다. Amazon Location 리소스 등 필요한 모든 AWS 리소스를 설명하는 템플릿을 생성하고, CloudFormation 는 그러한 리소스를 프로비저닝하고 구성합니다.
를 사용하면 템플릿을 재사용하여 Amazon Location 리소스를 일관되고 반복적으로 설정할 CloudFormation수 있습니다. 리소스를 한 번 설명한 다음 여러 AWS 계정 및 리전에서 동일한 리소스를 반복적으로 프로비저닝합니다.
## 관련 CloudFormation 템플릿
Amazon Location 및 관련 서비스에 대한 리소스를 프로비저닝하고 구성하려면 [CloudFormation 템플릿](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html)을 이해해야 합니다. 템플릿은 JSON 또는 YAML로 서식 지정된 텍스트 파일입니다. 이 템플릿은 CloudFormation 스택에서 프로비저닝할 리소스에 대해 설명합니다. JSON 또는 YAML에 익숙하지 않은 경우 Infrastructure Composer를 사용하여 CloudFormation 템플릿을 시작할 수 있습니다. 자세한 내용은 *CloudFormation 사용 설명서*의 [Infrastructure Composer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/infrastructure-composer-for-cloudformation.html)를 참조하세요.
Amazon Location은 CloudFormation에서 다음과 같은 리소스 유형의 생성을 지원합니다.
+ [AWS::Location::Tracker](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-tracker.html)
+ [AWS::Location::TrackerConsumer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-trackerconsumer.html)
+ [AWS::Location::GeofenceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-geofencecollection.html)
Amazon Location 리소스에 대한 JSON 및 YAML 템플릿의 예를 포함한 자세한 내용은 템플릿 참조의 [Amazon Location Service 리소스 유형 참조](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_Location.html)를 *CloudFormation 참조*하세요.
## 에 대해 자세히 알아보기 CloudFormation
에 대해 자세히 알아보려면 다음 리소스를 CloudFormation참조하세요.
+ [CloudFormation](https://aws.amazon.com/cloudformation)
+ [CloudFormation 사용 설명서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation API Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [CloudFormation 명령줄 인터페이스 사용 설명서](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)
# 모니터링 및 감사
모니터링 및 감사는 Amazon Location Services 환경에서 활동을 추적, 모니터링 및 로깅하는 기능을 제공합니다. Amazon CloudWatch 및 AWS CloudTrail을 사용하면 애플리케이션의 안정성, 보안 및 규정 준수를 보장할 수 있습니다.
이러한 도구를 사용하면 리소스 성능 지표를 관찰하고, 이상을 감지하고, 감사 및 문제 해결을 위한 API 활동을 로깅할 수 있습니다. 이를 사용하여 운영 인사이트를 높이고, 문제를 진단하고, 규정 준수 표준을 준수하도록 할 수 있습니다.
**Topics**
+ [Amazon CloudWatch를 사용하여 모니터링](cloudwatch.md)
+ [를 사용하여 모니터링 및 로깅 AWS CloudTrail](cloudtrail.md)
# Amazon CloudWatch를 사용하여 모니터링
Amazon CloudWatch는 AWS 리소스와 실행 중인 애플리케이션을 AWS 거의 실시간으로 모니터링합니다. 원시 데이터를 수집하여 지표를 거의 실시간으로 의미 있는 통계로 처리하는 CloudWatch를 통해 Amazon Location 리소스를 모니터링할 수 있습니다. Amazon CloudWatch 콘솔에서 최대 15개월 동안의 기록 정보를 보거나 확인할 지표를 검색하여 애플리케이션 또는 서비스가 어떻게 수행되고 있는지 더 자세히 알아볼 수 있습니다. 또한 임계값 지정에 의한 경보를 설정하여 해당 임계값이 충족될 때 알림을 전송하거나 조치를 취할 수 있습니다.
자세한 정보는 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.
**Topics**
+ [Amazon Location Service 지표 및 차원](#metrics-exported-to-cloudwatch)
+ [Amazon Location Service 지표 보기](#view-metrics)
+ [Amazon Location Service 지표에 대한 CloudWatch 경보 생성](#create-alarms)
+ [CloudWatch를 사용하여 할당량 대비 사용량 모니터링](#alarms-on-quotas)
+ [Amazon Location Service에 대한 CloudWatch 지표 예제](#example-alarms)
## Amazon Location Service 지표 및 차원
지표는 CloudWatch로 내보내는 시간별 데이터 포인트입니다. 차원이란 지표를 식별하는 이름/값 쌍을 말합니다. 자세한 내용은 Amazon CloudWatch 사용 설명서의 [CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)과 [CloudWatch 차원](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)을 참조하세요.
**참고**
Amazon Location Service의 분산 아키텍처로 인해 결과는 거의 비슷합니다. 대부분의 경우 개수는 전송 중인 실제 API 작업 수에 가까워야 합니다.
### Amazon Location Service 지표
다음은 Amazon Location Service가 `AWS/Location` 네임스페이스의 CloudWatch로 내보내는 지표입니다.
| 지표 | 설명 | 측정 기준 |
| --- | --- | --- |
| `CallCount` | 지정된 API 엔드포인트에 대한 호출 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName |
| `ErrorCount` | 지정된 API 엔드포인트에 대한 호출의 오류 응답 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
| `SuccessCount` | 지정된 API 엔드포인트에 대한 성공적인 호출 횟수. 유효한 통계: Sum 단위: 개 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
| `CallLatency` | 지정된 API 엔드포인트에 대한 호출이 이루어졌을 때 작업이 응답을 처리하고 반환하는 데 걸리는 시간. 유효한 통계: Average 단위: 밀리초 | OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName |
### 지표의 Amazon Location Service 차원
아래 표의 차원을 사용하여 Amazon Location Service 지표를 필터링할 수 있습니다.
| 차원 | 설명 |
| --- | --- |
| OperationName | 지정된 작업 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| OperationName, ResourceName | 지정된 작업 이름 및 리소스 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| ApiKeyName, OperationName | 지정된 작업 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| ApiKeyName, OperationName, ResourceName | 지정된 작업 이름, 리소스 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. |
| OperationName, OperationVersion | 지정된 작업 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location Service 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| OperationName, OperationVersion, ResourceName | 지정된 작업 이름, 버전 및 Amazon Location 리소스 이름으로 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| ApiKeyName, OperationName, OperationVersion | 지정된 작업 이름, 버전 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
| ApiKeyName, OperationName, OperationVersion, ResourceName | 지정된 작업 이름, 버전, 리소스 이름 및 지정된 API 키 이름을 사용하여 API 작업에 대한 Amazon Location 지표를 필터링합니다. Amazon Location 독립형 Maps, Places 및 Routes는 이 차원으로 지표를 내보냅니다. |
## Amazon Location Service 지표 보기
Amazon CloudWatch 콘솔에서 또는 Amazon CloudWatch API를 사용하여 Amazon Location Service에 대한 지표를 볼 수 있습니다.
**CloudWatch 콘솔을 사용하여 지표 보기**
**Example**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **지표**를 선택합니다.
1. **모든 지표** 탭에서 **위치** 네임스페이스를 선택합니다.
1. 확인하려는 지표 유형을 선택합니다.
1. 지표를 선택하여 차트에 추가합니다.
자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)를 참조하세요.
## Amazon Location Service 지표에 대한 CloudWatch 경보 생성
CloudWatch를 사용하여 Amazon Location Service 지표에 경보를 설정할 수 있습니다. 예를 들어, CloudWatch에서 경보를 생성하여 오류 횟수가 급증할 때마다 이메일을 보낼 수 있습니다.
다음 주제에서는 CloudWatch를 사용하여 경보를 설정하는 방법에 대한 상위 수준의 개요를 제공합니다. 구체적인 지침은 *Amazon CloudWatch 사용 설명서*의 [경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)을 참조하세요.
**CloudWatch 콘솔을 사용하여 경보를 설정하려면**
**Example**
1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 탐색 창에서 **경보**를 선택합니다.
1. **경보 생성**을 선택합니다.
1. **지표 선택**을 선택합니다.
1. **모든 지표** 탭에서 **위치** 네임스페이스를 선택합니다.
1. 지표 카테고리를 선택합니다.
1. 경보를 만들려는 지표가 있는 행을 찾은 다음 이 행 옆의 확인란을 선택합니다.
1. **지표 선택**을 선택합니다.
1. **지표**에서 값을 입력합니다.
1. 경보 **조건**을 지정합니다.
1. **다음**을 선택합니다.
1. 경보 조건이 충족될 때 알림을 보내려는 경우:
+ **경보 상태 트리거**에서 알림 전송 여부를 묻는 경보 상태를 선택합니다.
+ **SNS 주제 선택**에서 **새 주제 생성**을 선택하여 Amazon Simple Notification Service(SNS) 주제를 새로 생성합니다. 주제 이름과 알림을 보낼 이메일을 입력합니다.
+ **알림 수신처**에서 알림을 보낼 추가 이메일 주소를 입력합니다.
+ **알림 추가**를 선택합니다. 이 목록은 향후 경보를 위해 필드에 저장되고 표시됩니다.
1. 완료되면 **다음**을 선택합니다.
1. 경보의 이름과 설명을 입력하고 **다음**을 선택합니다.
1. 알람 세부 정보를 확인한 후 **다음**을 선택합니다.
**참고**
새 Amazon SNS 주제를 생성할 때에는, 이메일 주소를 확인해야 알림을 보낼 수 있습니다. 이메일이 확인되지 않은 경우, 상태 변경으로 경보가 시작될 때 알림이 수신되지 않습니다.
CloudWatch 콘솔을 사용하여 경보를 설정하는 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [이메일을 보내는 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)을 참조하세요.
## CloudWatch를 사용하여 할당량 대비 사용량 모니터링
Amazon CloudWatch 경보를 생성하여 지정된 할당량 사용률이 구성 가능한 임계값을 초과하는 경우 알림을 받을 수 있습니다. 이를 통해 할당량 한도에 근접했을 때를 인지하고 사용량을 조정하여 비용 초과가 발생하지 않도록 하거나 필요한 경우 할당량 증가를 요청할 수 있습니다.
CloudWatch를 사용하여 할당량을 모니터링하는 방법에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Service Quotas 시각화 및 경보 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)을 참조하세요.
## Amazon Location Service에 대한 CloudWatch 지표 예제
[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API를 사용하여 Amazon Location의 지표를 검색할 수 있습니다.
+ 예를 들어, 수치가 떨어질 때를 대비하여 이를 모니터링하고 `CallCount` 경보를 설정할 수 있습니다.
`SendDeviceLocation`의 `CallCount` 지표를 모니터링하면 추적된 자산을 한눈에 파악할 수 있습니다. `CallCount`이 하락했다면 트럭 플릿 등 추적 대상 자산이 현재 위치 전송을 중단했다는 뜻입니다. 이에 대한 경보를 설정하면 문제 발생을 알리는 데 도움이 될 수 있습니다.
+ 또 다른 예로, 수치가 급증할 때를 대비하여 이를 모니터링하고 `ErrorCount` 경보를 설정할 수 있습니다.
지오펜스를 기준으로 기기 위치를 평가하려면 트래커를 지오펜스 컬렉션과 연결해야 합니다. 지속적인 위치 업데이트가 필요한 디바이스 플릿이 있는 경우, `BatchEvaluateGeofence` 또는 `BatchPutDevicePosition`의 `CallCount`이 0으로 떨어지면 업데이트가 더 이상 진행되지 않는다는 의미입니다.
다음은 맵 리소스 생성을 위한 `CallCount` 및 `ErrorCount`에 대한 지표와 함께 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)에 대한 출력의 예입니다.
```
{
"StartTime": 1518867432,
"EndTime": 1518868032,
"MetricDataQueries": [
{
"Id": "m1",
"MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
"MetricName": "CallCount",
"Dimensions": [
{
"Name": "SendDeviceLocation",
"Value": "100"
}
]
},
"Period": 300,
"Stat": "SampleCount",
"Unit": "Count"
}
},
{
"Id": "m2",
"MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
"MetricName": "ErrorCount",
"Dimensions": [
{
"Name": "AssociateTrackerConsumer",
"Value": "0"
}
]
},
"Period": 1,
"Stat": "SampleCount",
"Unit": "Count"
}
}
]
}
```
# 를 사용하여 모니터링 및 로깅 AWS CloudTrail
AWS CloudTrail 는 사용자, 역할 또는 서비스가 수행한 작업에 대한 레코드를 제공하는 서비스입니다 AWS . CloudTrail은 모든 API 호출을 이벤트로 기록합니다. Amazon Location Service를 CloudTrail과 함께 사용하여 API 호출을 모니터링할 수 있습니다. 여기에는 Amazon Location Service 콘솔의 호출과 Amazon Location Service API 작업에 대한 AWS SDK 호출이 포함됩니다.
AWS CloudTrail은 계정을 생성할 때 자동으로 활성화됩니다. Amazon Location Service에서 활동이 발생하면 해당 활동이 **이벤트 기록**의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. AWS 리전별로 지난 90일 동안의 이벤트 기록을 보고 검색하고 다운로드할 수 있습니다.
CloudTrail에 대한 자세한 내용은 [AWS CloudTrail 사용자 안내서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하세요. **이벤트 기록** 보기는 CloudTrail 요금이 부과되지 않습니다.
Amazon Location Service의 이벤트를 포함하여 지난 90일 동안 AWS 계정에 이벤트를 지속적으로 기록하려면 추적 또는 [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) 데이터 스토어를 생성합니다.
**CloudTrail 추적**
CloudTrail은 추적을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 에서 추적을 생성하면 추적 AWS Management Console이 모든 AWS 리전에 적용됩니다. 추적은 AWS 파티션의 모든 리전에서 이벤트를 로깅하고 지정한 S3 버킷으로 로그 파일을 전송합니다. 또한 CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 조치를 취하도록 다른 AWS 서비스를 구성할 수 있습니다.
추적 생성 방법에 대한 자세한 내용은 [추적 생성 개요](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)를 참조하세요.
CloudTrail 지원 서비스 및 통합 목록은 [CloudTrail 지원 서비스 및 통합](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)을 참조하세요.
CloudTrail에서 추적을 생성하여 진행 중인 관리 이벤트의 사본 하나를 Amazon S3 버킷으로 무료로 전송할 수 있습니다. 하지만 Amazon S3 스토리지 요금이 부과됩니다.
CloudTrail 요금에 대한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요.
Amazon S3 요금에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.
**CloudTrail Lake 이벤트 데이터 스토어**
CloudTrail Lake를 사용하면 이벤트에 대해 SQL 기반 쿼리를 실행할 수 있습니다. 이벤트는 *이벤트 데이터 스토어*로 집계되며, 이벤트 데이터 스토어는 [고급 이벤트 선택기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors)를 적용하여 선택한 기준을 기반으로 하는 변경 불가능한 이벤트 컬렉션입니다. 이벤트 데이터 스토어에 적용하는 선택기는 어떤 이벤트가 지속되고 쿼리에 사용 가능한지를 제어합니다.
CloudTrail Lake에 대한 자세한 내용은 [AWS CloudTrail Lake 작업](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html)을 참조하세요.
CloudTrail Lake 이벤트 데이터 스토어 및 쿼리에는 비용이 발생합니다. 이벤트 데이터 스토어를 생성할 때 이벤트 데이터 스토어에 사용할 [요금 옵션](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option)을 선택합니다. 요금 옵션에 따라 이벤트 모으기 및 저장 비용과 이벤트 데이터 스토어의 기본 및 최대 보존 기간이 결정됩니다.
CloudTrail 요금에 대한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요.
**Topics**
+ [CloudTrail의 Amazon Location 관리 이벤트](#cloudtrail-management-events)
+ [CloudTrail의 Amazon Location 데이터 이벤트](#cloudtrail-data-events)
+ [Amazon Location Service 로그 파일 항목에 대해 알아보기](#cloudtrail-log-entries)
+ [예: Amazon Location 관리 이벤트에 대한 CloudTrail 로그 파일 항목](#cloudtrail-management-event-example)
+ [예: Amazon Location 데이터 이벤트에 대한 CloudTrail 로그 파일 항목](#cloudtrail-data-event-example)
## CloudTrail의 Amazon Location 관리 이벤트
CloudTrail 이벤트 기록에서 Amazon Location 관리 이벤트를 볼 수 있습니다. 이러한 이벤트에는 Amazon Location 리소스 및 구성을 관리하는 모든 API 호출이 포함됩니다. 지원되는 작업의 전체 목록은 [Amazon Location Service API 참조](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)를 참조하세요.
## CloudTrail의 Amazon Location 데이터 이벤트
데이터 이벤트는 리소스에서 직접 수행되는 작업에 대한 정보를 제공합니다. 데이터 플레인 작업이라고도 하는 이러한 이벤트는 대용량일 수 있습니다. 기본적으로 CloudTrail은 데이터 이벤트를 로깅하지 않으며 CloudTrail 이벤트 기록에는 이러한 이벤트가 기록되지 않습니다. 데이터 이벤트를 활성화하면 추가 요금이 발생합니다. CloudTrail 요금에 대한 자세한 내용은 [AWS CloudTrail 요금](https://aws.amazon.com/cloudtrail/pricing/)을 참조하세요.
CloudTrail 콘솔, AWS CLI 또는 CloudTrail API 작업을 사용하여 데이터 이벤트를 로깅할 Amazon Location 리소스 유형을 선택할 수 있습니다. 데이터 이벤트를 활성화하고 관리하는 방법에 대한 지침은 [AWS Management Console을 사용하여 데이터 이벤트 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) 및 [AWS 명령줄 인터페이스를 사용하여 데이터 이벤트 로깅](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI)을 참조하세요.
다음 표에는 데이터 이벤트를 로깅할 수 있는 Amazon Location 리소스 유형이 나열되어 있습니다.
**지원되는 Amazon Location 데이터 이벤트**
| 데이터 이벤트 유형(콘솔) | resources.type 값 | CloudTrail에 로깅되는 데이터 API |
| --- | --- | --- |
| Geo Maps | AWS::GeoMaps::Provider | [GeoMaps API 참조](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps)를 참조하세요. |
| Geo Places | AWS::GeoPlaces::Provider | [GeoPlaces API 참조](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places)를 참조하세요. |
| Geo Routes | AWS::GeoRoutes::Provider | [GeoRoutes API 참조](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes)를 참조하세요. |
**참고**
Amazon Location은 `GetStyleDescriptor`, `GetGlyphs` 및 `GetSprites` 등과 같은 GeoMaps API에 대한 CloudTrail 이벤트를 게시하지 않습니다. 이러한 API는 무료이며 인증이 필요하지 않습니다.
`eventName`, `readOnly` 및 `resources.ARN`을 기준으로 이벤트를 필터링하도록 고급 이벤트 선택기를 구성할 수 있습니다. 이렇게 하면 중요한 이벤트만 로깅할 수 있습니다. 자세한 내용은 [AdvancedFieldSelector](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)를 참조하세요.
## Amazon Location Service 로그 파일 항목에 대해 알아보기
추적을 구성하면 CloudTrail이 지정한 S3 버킷 또는 Amazon CloudWatch Logs에 이벤트를 로그 파일로 전송합니다. 자세한 내용은 AWS CloudTrail 사용 설명서의 [ CloudTrail 로그 파일 작업을 ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html) 참조하세요.
CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함될 수 있습니다. 각 이벤트 항목은 모든 소스로부터의 단일 요청을 나타내며 요청된 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 세부 정보가 포함되어 있습니다.
**참고**
CloudTrail 로그 파일은 API 호출의 정렬된 스택 추적이 아닙니다. 시간순으로 표시되지 않습니다. 작업 순서를 정하려면 `[eventTime](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_Event.html)`을 사용하세요.
모든 이벤트 또는 로그 항목에는 요청한 사용자에 대한 정보가 포함되어 있습니다. 이 자격 증명 정보를 이용하면 다음을 판단하는 데 도움이 됩니다.
+ 요청을 루트로 했는지 아니면 사용자 자격 증명으로 했는지 여부
+ 역할 또는 페더레이션 사용자에 대한 임시 보안 자격 증명을 사용하여 요청했는지 여부
+ 요청이 다른 AWS 서비스에 의해 이루어졌는지 여부입니다.
## 예: Amazon Location 관리 이벤트에 대한 CloudTrail 로그 파일 항목
다음 예는 트래커 리소스를 생성하는 `CreateTracker` 작업에 대한 CloudTrail 로그 항목을 보여줍니다.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "AssumedRole",
"principalId": "111122223333",
"arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "111122223333",
"arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
"accountId": "111122223333",
"userName": "exampleUser"
},
"webIdFederationData": {},
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2020-10-22T16:36:07Z"
}
}
},
"eventTime": "2020-10-22T17:43:30Z",
"eventSource": "geo.amazonaws.com",
"eventName": "CreateTracker",
"awsRegion": "us-east-1",
"sourceIPAddress": "SAMPLE_IP_ADDRESS",
"userAgent": "aws-internal/3 aws-sdk-java/1.11.864 Linux/4.14.193-110.317.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.8+10-LTS java/11.0.8 kotlin/1.3.72 vendor/Amazon.com_Inc. exec-env/AWS_Lambda_java11",
"requestParameters": {
"TrackerName": "ExampleTracker",
"Description": "Resource description"
},
"responseElements": {
"TrackerName": "ExampleTracker",
"Description": "Resource description",
"TrackerArn": "arn:partition:service:region:account-id:resource-id",
"CreateTime": "2020-10-22T17:43:30.521Z"
},
"requestID": "557ec619-0674-429d-8e2c-eba0d3f34413",
"eventID": "3192bc9c-3d3d-4976-bbef-ac590fa34f2c",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
## 예: Amazon Location 데이터 이벤트에 대한 CloudTrail 로그 파일 항목
다음 예제는 장소에 대한 좌표, 주소 및 기타 세부 정보를 검색하는 `Geocode` 작업에 대한 CloudTrail 로그 항목을 보여줍니다.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
"arn": "arn:aws:sts::111122223333:assumed-role/Admin/vingu-Isengard",
"accountId": "111122223333",
"accessKeyId": "ASIA6ODU7M352GLR5CFMSAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
"arn": "arn:aws:iam::111122223333:role/Admin",
"accountId": "111122223333",
"userName": "Admin"
},
"attributes": {
"creationDate": "2024-09-16T14:41:33Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-09-16T14:42:16Z",
"eventSource": "geo-places.amazonaws.com",
"eventName": "Geocode",
"awsRegion": "us-west-2",
"sourceIPAddress": "52.94.133.129",
"userAgent": "Amazon CloudFront",
"requestParameters": {
"Query": "***",
"Filter": {
"IncludeCountries": [
"USA"
]
}
},
"responseElements": null,
"requestID": "1ef7e0b8-c9fc-4a20-80c3-b5340d634c4e",
"eventID": "913d256c-3a9d-40d0-9bdf-705f12c7659f",
"readOnly": true,
"resources": [
{
"accountId": "111122223333",
"type": "AWS::GeoPlaces::Provider",
"ARN": "arn:aws:geoplaces:us-west-2:111122223333:provider"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "111122223333",
"eventCategory": "Data"
}
```
# 모범 사례
다음은 Amazon Location Service와 통합하기 위한 몇 가지 모범 사례입니다.
## 리소스 관리
Amazon Location Service에서 위치 리소스를 효과적으로 관리하려면 다음 모범 사례를 고려하세요.
**참고**
다음 모범 사례는 v1 APIs와 함께 사용되는 독립 실행형 리소스에 적용됩니다. v2 Maps, Places 및 Routes APIs는 리소스를 생성할 필요가 없습니다.
+ 예상 사용자 기반에서 중심이 되는 리전별 엔드포인트를 사용하여 사용자 경험을 개선하세요. 리전 엔드포인트에 대한 자세한 내용은 [Amazon Location 지원 리전](location-regions.md) 섹션을 참조하세요.
+ 맵 리소스 및 장소 색인 리소스와 같이 데이터 공급자를 사용하는 리소스의 경우 특정 데이터 공급자의 사용 약관을 준수해야 합니다. 자세한 내용은 [이용 약관 및 데이터 저작자 표시](data-attribution.md) 단원을 참조하십시오.
+ 맵, 장소 색인 또는 경로의 각 구성마다 하나의 리소스를 보유하여 리소스 생성을 최소화합니다. 리전 내에서는 일반적으로 데이터 공급자 또는 맵 스타일당 하나의 리소스만 필요합니다. 대부분의 애플리케이션은 기존 리소스를 사용하며 런타임 시 리소스를 생성하지 않습니다.
+ 맵 리소스 및 경로 계산기와 같은 단일 애플리케이션에서 서로 다른 리소스를 사용하는 경우 각 리소스에서 동일한 데이터 공급자를 사용하여 데이터가 일치하는지 확인하세요. 예를 들어, 경로 계산기로 생성한 경로 지오메트리는 맵 리소스를 사용하여 그린 맵의 거리와 일치합니다.
## 비용 및 청구 관리
비용 및 청구 관리에 도움이 되도록 다음 모범 사례를 고려하세요.
+ Amazon CloudWatch와 같은 모니터링 도구를 사용하여 리소스 사용량을 추적할 수 있습니다. 사용량이 지정된 한도를 초과하려 할 때 알려주는 알림을 설정할 수 있습니다. 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [예상 AWS 요금을 모니터링하기 위한 결제 경보 생성을 참조하세요](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html).
## 할당량 및 사용량
사용량의 기본 한도를 설정하는 할당량이 AWS 계정 포함되어 있습니다. 사용량이 한도에 가까워지면 알림을 받도록 알람을 설정하고 필요할 때 할당량 상향을 요청할 수 있습니다. 할당량 사용 방법에 대한 자세한 내용은 다음 항목을 참조하세요.
+ [Service Quotas를 사용하여 할당량 관리](manage-quotas.md)
+ [Amazon Location Service 지표에 대한 CloudWatch 경보 생성](cloudwatch.md#create-alarms)
+ *Amazon CloudWatch 사용 설명서*에서 [Service Quotas를 시각화하고 경보 설정](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)을 참조하세요.
한도 초과에 가까워지면 미리 경고를 표시하는 알람을 생성할 수 있습니다. Amazon Location을 사용하는 각의 각 할당량에 대해 경보 AWS 리전 를 설정하는 것이 좋습니다. 예를 들어 `SearchPlaceIndexForText` 작업 사용을 모니터링하여 현재 할당량의 80%를 초과할 경우 알람을 생성할 수 있습니다.
할당량에 대한 알람이 표시되면 수행할 작업을 결정해야 합니다. 고객 기반이 늘어났기 때문에 추가 리소스를 사용하고 있을 수 있습니다. 이 경우 해당 리전의 API 호출에 대한 할당량을 50% 늘리는 등 할당량 증가를 요청할 수 있습니다. 또는 Amazon Location에 불필요한 추가 호출을 발생시키는 서비스 오류가 있을 수도 있습니다. 이 경우에는 서비스에서 문제를 해결해 보는 것이 좋습니다.