本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 适用于 Amazon Location Service 的 AWS 集成 Amazon Location Service 与各种 AWS 服务集成，可实现高效的身份验证、监控、管理和开发。 **监控** + **Amazon CloudWatch** – 查看有关服务使用情况和运行状况的指标，包括请求、延迟、故障和日志。有关更多信息，请参阅 [使用 Amazon 进行监控 CloudWatch](cloudwatch.md)。 + **AWS CloudTrail** – 记录和监控您的 API 调用，包括用户、角色或 AWS 服务所采取的操作。有关更多信息，请参阅 [使用监控和登录 AWS CloudTrail](cloudtrail.md)。 **管理** + **AWS CloudFormation** – Amazon Location 与 AWS CloudFormation 集成，后者是一项服务，可帮助您对 AWS 资源进行建模和设置，这样您只需花较少的时间来创建和管理资源与基础设施。有关更多信息，请参阅 [使用创建资源 AWS CloudFormation](cloudformation.md)。 + **服务配额** – 使用服务配额控制台和 AWS CLI 请求更改您的可调整配额。有关更多信息，请参阅 [使用服务配额来管理配额](manage-quotas.md)。 + **标签** – 使用 Amazon Location 中的资源标签来创建标签，按用途、拥有者、环境或标准对您的资源进行分类。标记您的资源可以帮助您管理、识别、组织、搜索和筛选资源。有关更多信息，请参阅 [使用标签管理资源](manage-resources.md)。 **身份验证** + **Amazon Cognito** – 您可以使用 Amazon Cognito 身份验证作为直接使用 AWS Identity and Access Management（IAM）进行前端开发工具包和直接 HTTPS 请求的替代方案。有关更多信息，请参阅 [使用 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 函数激活应用程序和工作流程的其他部分。有关更多信息，请参阅 [使用亚马逊对亚马逊定位服务事件做出反应 EventBridge](location-events.md)。 + **AWS IoT** – AWS IoT Core 规则引擎存储有关设备消息主题的查询，并允许您定义向其他 AWS 服务（例如 Amazon Location Service）发送消息的操作。知道自己位置为坐标的设备可以通过规则引擎将其位置转发到 Amazon Location 。有关更多信息，请参阅 [通过 Amazon Location Service 使用 AWS IoT 和 MQTT 进行跟踪](tracking-using-mqtt.md)。 **开发人员工具** + **SDK** – Amazon Location Service 为开发人员提供了各种工具，供他们构建支持定位的应用程序。其中包括标准 AWS SDK、移动和 Web SDK。有关更多信息，请参阅 [SDKs 以及 Amazon Location Service 的框架](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 SDK、移动和 Web 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** + [使用服务配额来管理配额](manage-quotas.md) + [使用标签管理资源](manage-resources.md) + [使用 Billing and Cost Management 管理 AWS 账单和成本](manage-billing.md) + [使用创建资源 AWS CloudFormation](cloudformation.md) # 使用服务配额来管理配额 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 服务配额集成，该服务使您能够从中央位置查看和管理配额。有关更多信息，请参阅《服务配额用户指南》中的[什么是服务配额？](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)**。 使用 Service Quotas，可使用轻松查找 Amazon Location Service 配额的值。 ------ #### [ AWS 管理控制台 ] 1. 打开[服务限额控制台](https://console.aws.amazon.com/servicequotas)。 1. 在导航窗格中，选择 **AWS 服务**。 1. 从 **AWS 服务**列表中，搜索并选择 **Amazon Location**。 1. 在**服务配额**列表中，您可以看到服务配额名称、应用的值（如果可用）、 AWS 默认配额以及配额值是否可调整。 1. 要查看有关服务配额的其他信息（如描述），请选择配额名称。 1. （可选）要请求增加配额，请选择要增加的配额，选择 **Request quota increase（请求增加配额）**，输入或选择所需信息，然后选择 **Request（请求）**。 要使用控制台进一步处理服务配额，请参阅《服务配额用户指南》**。要请求提高配额，请参阅《服务配额用户指南》**中的[请求提高配额](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 命令参考*》中的 “服务配额” 部分。要请求增加配额，请参阅《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 以帮助管理服务容量，可以在[AWS 服务配额管理控制台中查看这些配额](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)申请增加 Amazon Location Service 配额，每个 API 的配额最多为默认限额的 2 倍。如果配额限制超过默认限额的 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/zh_cn/location/latest/developerguide/manage-quotas.html) ## 了解详情 有关服务配额的更多信息，请参阅[服务配额文档](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)。 # 使用标签管理资源 使用 Amazon Location 中的资源标签来创建标签，按用途、拥有者、环境或标准对您的资源进行分类。标记您的资源可以帮助您管理、识别、组织、搜索和筛选资源。例如，使用 Res AWS ource Groups，您可以基于一个或多个标签或部分标签创建 AWS 资源组。您也可以根据群组在 AWS CloudFormation 堆栈中的出现情况来创建群组。使用 Resource Groups 和标签编辑器，您可以在一个位置整合和查看由多个服务、资源和区域组成的应用程序的数据。有关[常见标记策略](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 Managem AWS ent 用户指南》中的使用标签控制对 AWS 资源的](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)*访问*。 ## 限制 **注意** 如果您添加的新标签的标签键与现有标签的相同，则新标签将覆盖现有标签。 使用标签，使您能够更有效地组织和管理您的资源。本页概述了在 Amazon Location Service 中管理标签使用的具体规则和限制。通过了解这些标记限制，便可以确保遵守最佳实践，并避免在为基于位置的资源和应用程序实施标记策略时出现潜在问题。 下面是适用于 标签的基本限制： + 每个资源的标签数上限：50 + 对于每个资源，每个标签键必须是唯一的，并且每个标签键只能有一个值。 + 最大键长度：128 个 Unicode 字符（采用 UTF-8 格式） + 最大值长度：256 个 Unicode 字符（采用 UTF-8 格式） + 允许在不同的服务中使用的字符包括：可以使用 UTF-8 表示的字母、数字和空格以及以下字符：\$1 - = . \$1 : / @。 + 标签键和值区分大小写。 + 该`aws:`前缀已保留供 AWS 使用。如果某个标签具有带有此标签键，则您无法编辑该标签的键或值。具有 aws: 前缀的标签不计入每个资源的标签数限制。 ## 授予标记资源的权限 您可以使用 IAM policy 来控制对您的 Amazon Location 资源的访问权限，并授予在创建资源时标记资源的权限。除了授予创建资源的权限外，该策略还可以包括允许标记操作的 Action 权限： + `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/*" ] } ``` ## 将标签添加到资源中 您可以使用亚马逊位置控制台、 AWS CLI 或亚马逊位置在创建资源时添加标签 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. 打开[账单和成本管理控制台](https://console.aws.amazon.com/billing)。 1. 在左侧导航窗格中，选择**成本分配标签**。 1. 在**用户定义的成本分配标签**选项卡下，选择要激活的标签密钥。 1. 选择**激活**。 激活标签后， 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 是一项网络服务，它提供的功能可帮助您支付账单和优化成本。Amazon Web Services 会根据您的使用情况向您的账户计费，这可确保您只需按实际用量付费。 **如何查看账单和管理成本** 1. 在中打开 “[账单和成本管理](https://console.aws.amazon.com/billing)” AWS 管理控制台。 1. 在 Amazon Web Services, Inc. 中搜索位置服务，其收费方式为按服务计费 1. 选择 **[\$1] 位置服务** 1. 选择 **[\$1] 区域名称** 有关更多信息，请参阅 AWS 管理控制台中的[账单和成本管理](https://console.aws.amazon.com/costmanagement/home#/getting-started)。 # 使用创建资源 AWS CloudFormation Amazon Location Service 与 CloudFormation一项服务集成，可帮助您对 AWS 资源进行建模和设置，从而减少创建和管理资源和基础设施所花费的时间。您可以创建一个描述所需的全部 AWS 资源的模板（例如 Amazon Location 资源），将为您 CloudFormation 预置和配置这些资源。 使用时 CloudFormation，您可以重复使用模板来一致且重复地设置您的亚马逊位置资源。描述一次您的资源，然后在多个 AWS 账户和区域中一遍又一遍地配置相同的资源。 ## 相关 CloudFormation 模板 要为 Amazon Location 和相关服务设置和配置资源，您必须了解 [CloudFormation 模板](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html)。模板是 JSON 或 YAML 格式的文本文件。这些模板可描述您要在 CloudFormation 堆栈中预调配的资源。如果您不熟悉 JSON 或 YAML，则可以使用基础设施编排器来帮助您开始使用 CloudFormation 模板。有关更多信息，请参阅《*CloudFormation 用户指南*[》中的 “基础设施编](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:: 地点:: TrackerConsumer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-trackerconsumer.html) + [AWS:: 地点:: GeofenceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-geofencecollection.html) 有关更多信息，包括亚马逊位置资源的 JSON 和 YAML 模板示例，请参阅*CloudFormation 模板[参考中的亚马逊定位服务资源类型](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_Location.html)参考*。 ## 了解更多关于 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 Service 环境中跟踪、监控和记录活动的功能。借助 Amazon CloudWatch 和 AWS CloudTrail，您可以确保应用程序的可靠性、安全性与合规性。 这些工具可帮助您监测资源性能指标，检测异常情况，并记录 API 活动以进行审计和故障排除。使用它们来增强运营洞察力，诊断问题，并确保遵守合规标准。 **Topics** + [使用 Amazon 进行监控 CloudWatch](cloudwatch.md) + [使用监控和登录 AWS CloudTrail](cloudtrail.md) # 使用 Amazon 进行监控 CloudWatch Amazon 近乎实时地 CloudWatch 监控您的 AWS 资源和您运行 AWS 的应用程序。您可以使用监控 Amazon Location 资源 CloudWatch，该资源可以近乎实时地收集原始数据并将指标处理成有意义的统计数据。您可以查看长达 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) + [CloudWatch Amazon Location Service 的指标示例](#example-alarms) ## Amazon Location Service 指标与维度 指标是导出到 CloudWatch的时间顺序数据点。维度是标识指标 name/value 的一对。有关更多信息，请参阅 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 中导出的指标。 | 指标 | 说明 | Dimensions | | --- | --- | --- | | `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 端点发出调用时，该操作处理和返回响应所花费的时间。 有效统计数据：平均值 单位：毫秒 | 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 独立的地图、地点和路线将作为该维度的导出指标。 | | 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. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。 1. 在导航窗格中，选择**指标**。 1. 在**所有指标**选项卡上，选择 **Location** 命名空间。 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. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。 1. 在导航窗格中，选择**警报**。 1. 选择**创建警报**。 1. 选择**选择指标**。 1. 在**所有指标**选项卡上，选择 **Location** 命名空间。 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)。 ## CloudWatch Amazon Location Service 的指标示例 您可以使用 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API 检索亚马逊位置的指标。 + 例如，您可以在数字下降时监控 `CallCount` 并设置警报。 监控 `SendDeviceLocation` 的 `CallCount` 指标可以帮助您深入了解被跟踪的资产。如果 `CallCount` 下降，则意味着被追踪的资产（例如卡车车队）已停止发送其当前位置。为此设置警报可以帮助通知您发生了问题。 + 再举一个例子，您可以监控 `ErrorCount` 并设置警报，以了解何时出现数量激增。 跟踪器必须与地理围栏集合相链接，才能根据地理围栏评估设备位置。如果您的设备群需要持续更新位置，看到 `BatchEvaluateGeofence` 或 `BatchPutDevicePosition` 的 `CallCount` 为零表示更新不再流动。 以下是创建地图资源的示例输出 [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 调用，其中包括来自亚马逊定位服务控制台的调用和对亚马逊定位服务 API 操作的 AWS SDK 调用。 CloudTrail 在您创建 AWS 账户时会自动启用。当 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)。 通过创建跟踪，您可以免费将正在进行的管理事件的一份副本传送到 Amazon S3 存储桶。 CloudTrail 但会收取 Amazon S3 存储费用。 有关 CloudTrail 定价的更多信息，请参阅[AWS CloudTrail 定价](https://aws.amazon.com/cloudtrail/pricing/)。 有关 Amazon S3 定价的信息，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。 **CloudTrail 湖泊事件数据存储** 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 湖泊事件数据存储和查询会产生费用。创建事件数据存储时，您可以选择要用于事件数据存储的[定价选项](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** + [中的 Amazon 位置管理事件 CloudTrail](#cloudtrail-management-events) + [中的亚马逊位置数据事件 CloudTrail](#cloudtrail-data-events) + [了解 Amazon Location Service 日志文件条目](#cloudtrail-log-entries) + [示例：Amazon 位置管理事件的 CloudTrail 日志文件条目](#cloudtrail-management-event-example) + [示例：Amazon 位置数据事件的 CloudTrail 日志文件条目](#cloudtrail-data-event-example) ## 中的 Amazon 位置管理事件 CloudTrail 您可以在活动历史记录中查看 Amazon 位置管理 CloudTrail 事件。这些事件包括管理 Amazon Location 资源和配置的所有 API 调用。有关支持的操作的完整列表，请参阅 [Amazon Location Service API 参考](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)。 ## 中的亚马逊位置数据事件 CloudTrail 数据事件提供有关直接对资源执行的操作的信息。这些事件也称为数据面板操作，可能容量很大。默认情况下， 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 数据事件** | 数据事件类型（控制台） | resources.type 值 | 数据 APIs 已记录到 CloudTrail | | --- | --- | --- | | 地理地图 | AWS::GeoMaps::Provider | 参见亚马逊 [GeoMaps API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps) 参考 | | 地理地点 | AWS::GeoPlaces::Provider | 参见亚马逊 [GeoPlaces API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places) 参考 | | 地理路线 | AWS::GeoRoutes::Provider | 参见亚马逊 [GeoRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes) 参考 | **注意** Amazon Location 不会发布以下 CloudTrail 事件 GeoMaps APIs：`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 位置管理事件的 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 位置数据事件的 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 地图、地点和路线 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 账户 包含的配额会为您的使用量设置默认限制。您可以设置警报，以便在使用量接近上限时提醒您，也可以在需要时请求提高配额。有关如何处理配额的信息，请参阅以下主题。 + [使用服务配额来管理配额](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 地点的每个配额中为每个 AWS 区域 配额设置警报。例如，您可以监控 `SearchPlaceIndexForText` 操作的使用情况，并在超过当前配额的 80% 时创建警报。 当你收到有关配额的警报警告时，你必须决定该怎么做。您可能正在使用其他资源，因为您的客户群已经扩大。在这种情况下，您可能需要申请增加配额，例如将该区域的 API 地理围栏配额增加 50%。或者，您的服务中可能存在错误，导致您对 Amazon Location 进行其他不必要的调用。在这种情况下，你需要解决服务中的问题。