本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # AWS Amazon Location Service 的 整合 Amazon Location Service 與各種 AWS 服務整合，以實現高效的身分驗證、監控、管理和開發。 **監控** + **Amazon CloudWatch** – 檢視服務用量和運作狀態的指標，包括請求、延遲、故障和日誌。如需詳細資訊，請參閱[使用 Amazon CloudWatch 監控](cloudwatch.md)。 + **AWS CloudTrail** – 記錄和監控您的 API 呼叫，其中包括使用者、角色或服務 AWS 所採取的動作。如需詳細資訊，請參閱[使用 監控和記錄 AWS CloudTrail](cloudtrail.md)。 **Manage (管理)** + **AWS CloudFormation** – Amazon Location 已與 整合 AWS CloudFormation，此服務可協助您建立和設定 AWS 資源的模型，以減少建立和管理資源和基礎設施的時間。如需詳細資訊，請參閱[使用 建立資源 AWS CloudFormation](cloudformation.md)。 + **Service Quotas** – 使用 Service Quotas 主控台和 AWS CLI 請求變更可調整的配額。如需詳細資訊，請參閱[使用 Service Quotas 管理配額](manage-quotas.md)。 + **標籤** – 在 Amazon Location 中使用資源標記來建立標籤，以根據用途、擁有者、環境或條件來分類您的資源。標記資源可協助您管理、識別、組織、搜尋和篩選資源。如需詳細資訊，請參閱[使用標籤管理資源](manage-resources.md)。 **驗證** + **Amazon Cognito** – 您可以使用 Amazon Cognito 身分驗證作為直接搭配前端 SDK 和直接 HTTPS 請求使用 AWS Identity and Access Management (IAM) 的替代方案。 SDKs 如需詳細資訊，請參閱[使用 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 規則引擎會儲存有關裝置訊息主題的查詢，並可讓您定義將訊息傳送至其他服務的動作 AWS ，例如 Amazon Location Service。知道其位置做為座標的裝置，可以透過規則引擎將其位置轉送至 Amazon Location。如需詳細資訊，請參閱[搭配 Amazon Location Service 使用 AWS IoT 和 MQTT 進行追蹤](tracking-using-mqtt.md)。 **開發人員工具** + **SDKs** – Amazon Location Service 提供各種工具，供開發人員建置啟用位置的應用程式。其中包括 AWS SDKs、行動和 Web SDKs。如需詳細資訊，請參閱[適用於 Amazon Location Service SDKs 和架構](dev-sdks.md)。 + **AWS CLI** – AWS Command Line Interface (AWS CLI) 是一種開放原始碼工具，可讓您使用命令列 Shell 中的命令與 AWS 服務互動。最少的組態。如需詳細資訊，請參閱 [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/location/)或進一步了解 [AWS CLI](https://docs.aws.amazon.com/cli/)。 + **範例程式碼**：範例程式碼使用 AWS SDKs、行動和 Web SDKs、MapLibre 來示範如何使用 Amazon Location。如需詳細資訊，請參閱[範例](https://location.aws.com/samples)。 + **Amazon Location Service 主控台** – 使用 Amazon Location 主控台來了解 APIs、資源，並開始使用視覺化和互動式學習工具。如需詳細資訊，請參閱 [Amazon Location Service 主控台](https://console.aws.amazon.com/location/explore/home)。 **成本和帳單** + **AWS Billing and Cost Management** – 服務可協助您支付帳單並最佳化成本。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 拒絕超出服務配額的其他請求。 速率限制 （以速率... 開頭的配額） 是每秒請求數上限，爆量速率為每秒任何部分內限制的 80%，針對每個 API 操作定義。透過 Service Quotas 為帳戶提高速率限制的操作，其爆量速率可能會低於提高速率限制的 80%。Amazon Location Service 會調節超出操作速率限制的請求。 ## 管理您的 Amazon Location 服務配額 Amazon Location Service 與 Service Quotas 整合，這項 AWS 服務可讓您從中央位置檢視和管理配額。如需詳細資訊，請參閱[什麼是 Service Quotas？](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) 《*Service Quotas 使用者指南*》中的 。 Service Quotas 可讓您輕鬆查詢 Amazon Location 服務配額的值。 ------ #### [ AWS 管理主控台 ] 1. 開啟 [Service Quotas 主控台](https://console.aws.amazon.com/servicequotas)。 1. 在導覽窗格中，選擇 **AWS services (AWS 服務)**。 1. 從**AWS 服務**清單中，搜尋並選取 **Amazon Location**。 1. 在**服務配額**清單中，您可以看到服務配額名稱、套用值 （如果有的話）、 AWS 預設配額，以及配額值是否可以調整。 1. 若要檢視服務配額的其他資訊 (例如說明)，請選擇配額名稱。 1. (選用) 若要請求增加配額，請選取您要增加的配額、選取 **Request quota increase (請求增加配額)**、輸入或選取必要資訊，然後選取 **Request (請求)**。 若要使用主控台使用更多服務配額，請參閱 *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)中的 。 ------ ## 常見問答集 **Amazon Location Service 資源的預設配額是多少？** Amazon Location Service 會為 APIs 設定預設配額，以協助管理可在 Service [AWS Service Quotas管理主控台](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)中檢視的服務容量。您可以在以下[監控 Amazon Location 服務配額](#manage-quotas_monitor)章節中找到所有這些項目的連結。 **如何請求提高 Amazon Location Service 的配額？** 您可以透過[自助式主控台](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)請求增加 Amazon Location Service 配額，最多可達每個 API 預設限制的 2 倍。對於超過預設限制 2 倍的配額限制，請在自助式主控台中請求，然後提交支援票證。或者，您可以連接您的高級支援團隊 **要求提高 Amazon Location Service 配額是否有相關的額外費用？** 配額增加請求不會產生直接費用，但較高的用量層級可能會根據使用的額外資源而增加服務成本。 ## 監控 Amazon Location 服務配額 您可以使用 Amazon CloudWatch 根據配額監控用量。如需詳細資訊，請參閱[使用 Amazon CloudWatch 監控](cloudwatch.md)。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/location/latest/developerguide/manage-quotas.html) ## 進一步了解 若要進一步了解服務配額，請參閱 [Service Quotas 文件](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)。 # 使用標籤管理資源 使用 Amazon Location 中的資源標記來建立標籤，依用途、擁有者、環境或條件來分類您的資源。標記資源可協助您管理、識別、組織、搜尋和篩選資源。例如，使用 AWS 資源群組，您可以根據一或多個標籤或標籤部分來建立 AWS 資源群組。您也可以根據群組在 an AWS CloudFormation 堆疊中出現的情況來建立群組。使用資源群組和標籤編輯器，您可以合併將多項服務、資源和區域集結在一處的應用程式資料，然後進行檢視。如需[常見標記策略](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 資源的存取，請參閱《 Identity and Access Management 使用者指南》中的[使用標籤控制對 AWS 資源](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)的存取。 *AWS * ## 限制 **注意** 若您使用與現有標籤相同的標籤金鑰新增新的標籤，新的標籤會覆寫現有的標籤。 標記可讓您更有效地組織和管理 資源。此頁面概述管理 Amazon Location Service 內標籤使用的特定規則和限制條件。透過了解這些標記限制，您可以確保符合最佳實務，並避免針對以位置為基礎的資源和應用程式實作標記策略時的潛在問題。 以下基本限制適用於 標籤： + 每個資源的標籤上限：50 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 索引鍵長度上限：128 個 UTF-8 Unicode 字元 + 值長度上限：256 個 UTF-8 Unicode 字元 + 服務間允許的字元包括：可用 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 主控台、CLI 或 Amazon Location APIs AWS 建立資源時新增標籤： + [管理您的地理圍欄集合資源](managing-geofence-collections.md) + [建立追蹤器](start-create-tracker.md) **若要標記現有資源，請編輯或刪除標籤** 1. 開啟 [Amazon Location 主控台](https://console.aws.amazon.com/location)。 1. 在左側導覽窗格中，選擇您要標記的資源。例如 **Maps**。 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. 開啟[帳單和成本管理主控台](https://console.aws.amazon.com/billing)。 1. 在左側導覽窗格中，選擇**成本分配標籤**。 1. 在**使用者定義的成本分配標籤**索引標籤下，選取您要啟用的標籤索引鍵。 1. 選擇 **Activate (啟用)**。 啟用標籤後， 會為您的資源用量和成本 AWS 產生[每月成本分配報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)。此成本分配報告包含每個計費期間的所有 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 是一種 Web 服務，提供可協助您支付帳單和最佳化成本的功能。Amazon Web Services 會向您的帳戶收取使用費，這可確保您只需支付使用量的費用。 **如何查看帳單和管理成本** 1. 在 中開啟 [Billing and Cost Management](https://console.aws.amazon.com/billing) AWS 管理主控台。 1. 依服務搜尋 Amazon Web Services， Inc. 中的位置服務 1. 選擇 **【＋】 位置服務** 1. 選擇 **【＋】 區域名稱** 若要進一步了解，請參閱《》中的[帳單與成本管理](https://console.aws.amazon.com/costmanagement/home#/getting-started) AWS 管理主控台。 # 使用 建立資源 AWS CloudFormation Amazon Location Service 已與 整合 CloudFormation，這項服務可協助您模型化和設定 AWS 資源，以減少建立和管理資源和基礎設施的時間。您可以建立範本來描述您想要的所有 AWS 資源 （例如 Amazon Location 資源），並 CloudFormation 為您佈建和設定這些資源。 使用 時 CloudFormation，您可以重複使用範本來一致且重複地設定 Amazon Location 資源。描述您的資源一次，然後在多個 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 參考](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 資源，該資源會收集原始資料，並近乎即時地將指標處理成有意義的統計資料。您可以檢視長達 15 個月的歷史資訊，或在 Amazon CloudWatch 主控台中搜尋要檢視的指標，以進一步了解應用程式或服務的效能。您也可以定義閾值來設定警示，並在達到這些閾值時傳送通知或採取動作。 如需詳細資訊，請參閱 [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 維度 CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。 Amazon CloudWatch **注意** 由於 Amazon Location Service 的分散式架構，結果為近似值。在大多數情況下，計數應接近實際傳送的 API 操作數量。 ### Amazon Location Service 指標 以下是 Amazon Location Service 在 `AWS/Location` 命名空間中匯出至 CloudWatch 的指標。 | 指標 | Description | 維度 | | --- | --- | --- | | `CallCount` | 對指定 API 端點進行的呼叫數。 有效統計資訊：總和 單位：Count | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName OperationName、OperationVersion OperationName、OperationVersion、ResourceName ApiKeyName、OperationName、OperationVersion ApiKeyName、OperationName、OperationVersion、ResourceName | | `ErrorCount` | 對指定 API 端點發出的呼叫的錯誤回應數目。 有效統計資訊：總和 單位：Count | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | | `SuccessCount` | 對指定 API 端點進行的成功呼叫數。 有效統計資訊：總和 單位：Count | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | | `CallLatency` | 對指定 API 端點進行呼叫時，操作處理和傳回回應所需的時間。 有效的統計數字：平均 單位：毫秒 | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | ### 指標的 Amazon Location Service 維度 您可以使用下表中的維度來篩選 Amazon Location Service 指標。 | 維度 | Description | | --- | --- | | 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 獨立地圖、位置和路由會將指標匯出至此維度。 | | OperationName、OperationVersion、ResourceName | 使用指定的操作名稱、版本和 Amazon Location 資源名稱，篩選 API 操作的 Amazon Location 指標。 Amazon Location 獨立地圖、位置和路由將匯出指標到此維度。 | | ApiKeyName、OperationName、OperationVersion | 使用指定的操作名稱、版本和指定的 API 金鑰名稱，篩選 API 操作的 Amazon Location 指標。 Amazon Location 獨立地圖、位置和路由將匯出指標到此維度。 | | ApiKeyName、OperationName、OperationVersion、ResourceName | 使用指定的操作名稱、版本、資源名稱和使用指定的 API 金鑰名稱，篩選 API 操作的 Amazon Location 指標。 Amazon Location 獨立地圖、位置和路由將匯出指標到此維度。 | ## 檢視 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. 選擇 **Select metric** (選取指標)。 1. **在所有指標**索引標籤上，選取**位置**命名空間。 1. 選取指標類別。 1. 尋找具有您要為其建立警示之指標的資料列，然後選取此資料列旁的核取方塊。 1. 選擇**選取指標**。 1. 在**指標**下，填入值。 1. 指定警示**條件**。 1. 選擇**下一步**。 1. 如果您想要在符合警示條件時傳送通知： + 在**警示狀態觸發**下，選取警示狀態以提示傳送通知。 + 在**選取 SNS 主題**下，選擇**建立新主題**以建立新的 Amazon Simple Notification Service (Amazon SNS) 主題。輸入要傳送通知的主題名稱和電子郵件。 + 在**傳送通知下，**輸入要傳送通知的其他電子郵件地址。 + 選擇 **Add notification** (新增通知)。此清單會儲存並顯示在欄位中供未來警示使用。 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 使用者指南*》中的[視覺化您的服務配額和設定警示](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`和設定發生數字下降時的警示。 監控 的`CallCount`指標`SendDeviceLocation`可協助您了解追蹤資產。如果 `CallCount`下降，這表示追蹤的資產，例如卡車機群，已停止傳送其目前位置。為此設定警示有助於通知您發生了問題。 + 針對另一個範例，您可以監控`ErrorCount`並設定 的警示，以便在發生數字峰值時發出警示。 追蹤器必須與地理圍欄集合相關聯，才能針對地理圍欄評估裝置位置。如果您有需要持續位置更新的裝置機群，請參閱 `CallCount` 的 `BatchEvaluateGeofence`或 `BatchPutDevicePosition` 降至零，表示更新不再流動。 以下是 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) 的範例輸出，其中包含`ErrorCount`用於建立映射資源的 `CallCount`和 指標。 ``` { "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 費用。 如需 AWS 您帳戶中過去 90 天事件的持續記錄，包括來自 Amazon Location Service 的事件，請建立追蹤或 [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) 資料存放區。 **CloudTrail 追蹤** 線索能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。當您在 中建立線索時 AWS 管理主控台，線索會套用至所有 AWS 區域。線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案傳送到您指定的 S3 儲存貯體。此外，您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。 如需如何建立線索的詳細資訊，請參閱[建立線索的概觀](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 管理主控台記錄資料事件](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 Data Events** | 資料事件類型 (主控台) | resources.type 值 | 記錄到 CloudTrail 的資料 API | | --- | --- | --- | | 地理地圖 | AWS::GeoMaps::Provider | 請參閱 Amazon [GeoMaps API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps) 參考 | | 地理位置 | AWS::GeoPlaces::Provider | 請參閱 Amazon [GeoPlaces API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places) 參考 | | 地理路由 | AWS::GeoRoutes::Provider | 請參閱 Amazon [GeoRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes) 參考 | **注意** Amazon Location 不會發佈下列 GeoMaps APIs CloudTrail 事件：`GetStyleDescriptor`、 `GetGlyphs`和 `GetSprites`。這些 APIs 是免費的，不需要身分驗證。 您可以設定進階事件選取器，依 `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 使用者指南*》中的[視覺化您的服務配額和設定警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)。 您可以建立警示，以便在接近超過限制時預先發出警告。建議您在使用 Amazon Location AWS 區域 的每個 中為每個配額設定警示。例如，您可以監控`SearchPlaceIndexForText`操作的使用，並在超過目前配額的 80% 時建立警示。 當您收到有關配額的警示警告時，您必須決定要做什麼。您可能會使用其他資源，因為您的客戶群已成長。在這種情況下，您可能想要請求提高配額，例如該區域中 API 呼叫的配額增加 50%。或者，您的服務可能發生錯誤，導致您對 Amazon Location 進行其他不必要的呼叫。在這種情況下，您想要解決服務中的問題。