Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

监控和日志记录

您可以使用 Amazon CloudWatch 监控和调试AmazonAppSync。使用AmazonAppSync，您可以使用 GraphQL 从云中请求数据。很多时候，您希望获得有关 API 执行情况的更多信息。为了帮助调试与 GraphQL API 的请求执行相关的问题，您可以启用 Amazon CloudWatch Logs 以监控 API 调用。在您通过 CloudWatch 启用后，AmazonAppSync 记录云监视中的 API 调用。

设置和配置

您可以通过 GraphQL API 自动启用日志记录。AmazonAppSync 控制台。

手动角色配置

要启用 CloudWatch Logs，您必须授予AmazonAppSync 正确的权限，以写入日志到 CloudWatch 的 CloudWatch。为此，您需要提供一个服务角色 ARN，以便Amazon在写入日志时，AppSync 可以担任此角色。

首先，导航到 IAM 控制台。然后，使用名称为AWSAppSyncPushToCloudWatchLogsPolicy，具有以下定义：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": "*"
        }
    ]
}

接下来，使用名称 AWSAppSyncPushToCloudWatchLogsRole 创建新的角色，然后将上述策略附加到此角色。编辑此角色的信任关系以具有以下内容：

{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Principal": {
            "Service": "appsync.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
        }
    ]
}

复制角色 ARN 并将其注册到AmazonAppSync 以支持写入 CloudWatch。

CloudWatch 指标

您可以使用 CloudWatch 指标来监控并提供有关特定事件的提醒，这些事件可能是由 HTTP 状态代码或延迟触发的，例如总体 GraphQL 请求和响应延迟。以下是发出的指标。

实时订阅

所有指标都在一个维度中发出：GraphQLAPIId. 这意味着所有指标都与 GraphQL API ID 相结合。以下指标与纯 WebSocket 上的 GrapQL 订阅相关：

CloudWatch Logs (CloudWatch 日志)

您可以对任何新的或现有的 GraphQL API 配置两种类型的日志记录：请求级别和字段级别。

请求级别日志

启用时，系统会记录以下信息：

字段级别日志

启用时，系统会记录以下信息：

如果您开启日志记录，AmazonAppSync 管理 CloudWatch Logs。该过程包括创建日志组和日志流，以及向日志流报告这些日志。

当您对 GraphQL API 启用日志记录并发起请求时，AmazonAppSync 创建日志组和日志组下的日志流。日志组以 /aws/appsync/apis/{graphql_api_id} 格式命名。在每个日志组内，日志会进一步分成多个日志流。当报告已记录的数据时，这些日志按上次事件时间排序。

每个日志事件都用该请求的 x-amzn-RequestId 进行标记。这有助于您在 CloudWatch 中筛选日志事件，以获取与该请求相关的所有已记录的信息。您可以从每个 GraphQL 的响应标头中获取 RequestId。AmazonAppSync 请求。

字段级别日志记录配置为使用以下日志级别：

启用监控的优势

您可以使用日志记录和指标来识别、优化 GraphQL 查询和排除其问题。例如，这些将帮助您使用针对查询中的每个字段记录的跟踪信息调试延迟问题。为了对此进行演示，假设您正在使用一个或多个嵌套在 GraphQL 查询中的解析程序。CloudWatch Logs 中的示例字段执行可能类似于以下内容：

{
    "path": [
        "singlePost",
        "authors",
        0,
        "name"
    ],
    "parentType": "Post",
    "returnType": "String!",
    "fieldName": "name",
    "startOffset": 416563350,
    "duration": 11247
}

这可能对应于 GraphQL 架构，类似于以下内容：

type Post {
  id: ID!
  name: String!
  authors: [Author]
}

type Author {
  id: ID!
  name: String!
}

type Query {
  singlePost(id:ID!): Post
}

在上面的日志结果中，path 显示从运行名为 singlePost() 的查询所返回的数据中的单个项目。在本例中，它表示位于第一个索引 (0) 处的 name 字段。startOffset 给出 GraphQL 查询执行开始时的偏移量。duration 是解析该字段的总时间。这些值可用来排除下面这类问题：为何来自特定数据源的数据的运行速度可能低于预期，或者特定字段是否降低了整个查询的速度等。例如，您可能选择增加 Amazon DynamoDB 表的预配置吞吐量，或者从查询中删除导致整体执行效果不佳的某个字段。

截至 2019 年 5 月 8 日，AmazonAppSync 生成日志事件为完全结构化的 JSON。这使您能够使用日志分析服务（如 Amazon CloudWatch Logs Insights 和 Amazon Elasticsearch Service）以了解 GraphQL 请求的性能和架构字段的使用特征。例如，您可以轻松识别具有较大延迟的解析程序，这可能是导致性能问题的根本原因。您还可以识别架构中最常用和最不常用的字段，并评估弃用 GraphQL 字段的影响。

冲突检测和同步日志记录

如果AmazonAppSync API 已启用 CloudWatch Logs，并将日志记录设置设置为字段级日志enabled和日志级别的字段级别日志设置为ALL，然后AmazonAppSync 将向日志组发出冲突检测和解决信息。这将为您提供细致的见解，了解Amazon当检测到冲突时，AppSync API 决定采取。为此，将在日志中提供以下信息：

日志类型参考

RequestSummary

{
     "logType": "RequestSummary",
     "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
     "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4",
     "statusCode": 200,
     "latency": 242000000
}

ExecutionSummary

{
    "duration": 217406145,
    "logType": "ExecutionSummary",
    "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
    "startTime": "2019-01-01T06:06:18.956Z",
    "endTime": "2019-01-01T06:06:19.174Z",
    "parsing": {
        "startOffset": 49033,
        "duration": 34784
    },
    "version": 1,
    "validation": {
        "startOffset": 129048,
        "duration": 69126
    },
    "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4"
}

Tracing

{
    "duration": 216820346,
    "logType": "Tracing",
    "path": [
        "putItem"
    ],
    "fieldName": "putItem",
    "startOffset": 178156,
    "resolverArn": "arn:aws:appsync:us-east-1:111111111111:apis/pmo28inf75eepg63qxq4ekoeg4/types/Mutation/fields/putItem",
    "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
    "parentType": "Mutation",
    "returnType": "Item",
    "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4"
}

使用 Amazon CloudWatch Logs Insights 分析您的日志

以下是您可以运行的查询示例，以获取有关 GraphQL 操作的性能和运行状况的可行的见解。这些示例可作为 CloudWatch Logs Insights 控制台中的示例查询提供。在Amazon CloudWatch 控制台中，选择记录见解中，选择Amazon您的 GraphQL SQL API 的 AppSync 日志组，然后选择Amazon AppSyncqueriesUNDER示例查询.

以下查询返回具有最大延迟的前 10 个 GraphQL 请求：

  fields requestId, latency
| filter logType = "RequestSummary"
| limit 10
| sort latency desc

以下查询返回具有最大延迟的前 10 个解析程序：

  fields resolverArn, duration
| filter logType = "Tracing"
| limit 10
| sort duration desc

以下查询返回最常调用的解析程序：

  fields ispresent(resolverArn) as isRes
| stats count() as invocationCount by resolverArn
| filter isRes and logType = "Tracing"
| limit 10
| sort invocationCount desc

以下查询返回映射模板中具有最多错误的解析程序：

  fields ispresent(resolverArn) as isRes
| stats count() as errorCount by resolverArn, logType
| filter isRes and (logType = "RequestMapping" or logType = "ResponseMapping") and fieldInError
| limit 10
| sort errorCount desc

以下查询返回解析程序延迟统计数据：

  fields ispresent(resolverArn) as isRes
| stats min(duration), max(duration), avg(duration) as avg_dur by resolverArn
| filter isRes and logType = "Tracing"
| limit 10
| sort avg_dur desc

以下查询返回字段延迟统计数据：

  stats min(duration), max(duration), avg(duration) as avg_dur
  by concat(parentType, '/', fieldName) as fieldKey
| filter logType = "Tracing"
| limit 10
| sort avg_dur desc

CloudWatch Logs Insights 查询的结果可以导出到 CloudWatch 控制面板。

使用 Amazon Elasticsearch Service 分析您的日志

您可以搜索、分析和可视化Amazon使用 AppSync 日志Amazon Elasticsearch Service以确定性能瓶颈和操作问题的根本原因。您可以识别具有最大延迟和最多错误的解析程序。此外，您可以使用 Kibana 创建具有强大可视化效果的仪表板。Kibana 是 Amazon ES 中提供的开源数据可视化和挖掘工具。使用 Kibana 控制面板，您可以持续监控 GraphQL 操作的性能和运行状况。例如，您可以创建控制面板，使您能够可视化 GraphQL 请求的 P90 延迟，并深入了解每个解析程序的 P90 延迟。

当使用 Amazon ES 时，请使用“cwl*”作为筛选器模式来搜索 Elasticsearch 索引。Elasticsearch 将为从 CloudWatch Logs 流式传输而来的日志编制索引，前缀为“cwl-”。区分Amazon来自其他 CloudWatch Logs 的 AppSync API 日志，建议您添加graphQLAPIID.keyword=YourGraphQLAPIID添加到您的搜索中。

日志格式迁移

生成的记录事件Amazon2019 年 5 月 8 日或之后的 AppSync 格式为完全结构化的 JSON。如果要在 2019 年 5 月 8 日之前分析 GraphQL 请求，可以使用 GitHub 示例中提供的脚本将以前的日志迁移到完全结构化的 JSON。如果需要在 2019 年 5 月 8 日之前使用日志格式，请使用以下设置创建支持服务单：将 Type (类型) 设置为 Account Management (账户管理)，然后将 Category (类别) 设置为 General Account Question (一般账户问题)。

还可以选择启用指标筛选条件中的 CloudWatch。然后，您可以使用这些指标筛选条件将日志数据转换为 CloudWatch 指标，以便对它们生成图表或设置警报。