对 Application Signals 安装进行问题排查

检查应用程序是否已被其他监控解决方案检测过。Application Signals 可能不支持与其他检测解决方案共存。

确认您的应用程序符合使用 Application Signals 的兼容性要求。有关更多信息，请参阅 Application Signals 支持的系统 。

如果您的应用程序未能拉取 Application Signals 构件，例如 Amazon Distro for OpenTelemetery Java 或 Python 代理和 CloudWatch 代理映像，则可能是网络问题。

使用 --noreload 标志可防止自动重新加载。

将 DJANGO_SETTINGS_MODULE 环境变量设置为 Django 应用程序 settings.py 文件的位置。这样可确保 OpenTelemetry 能够正确访问您的 Django 设置，并与之集成。

确保您正在使用的库和框架受 ADOT Java 代理的支持。有关更多信息，请参阅库/框架。

确保 CloudWatch 代理正在运行。首先检查 CloudWatch 代理容器组（pod）的状态，并确保它们都处于 Running 状态。

kubectl -n amazon-cloudwatch get pods.

将以下内容添加到 CloudWatch 代理配置文件中以启用调试日志，然后重新启动代理。

"agent": {

  "region": "${REGION}",
  "debug": true
},

然后检查 CloudWatch 代理容器组（pod）中是否存在错误。

检查 CloudWatch 代理的配置问题。确认以下内容仍在 CloudWatch 代理配置文件中，并且自添加以来，代理曾重新启动。

"agent": {
  "region": "${REGION}",
  "debug": true
},

然后查看 OpenTelemetry 调试日志中是否有错误消息，例如 ERROR io.opentelemetry.exporter.internal.grpc.OkHttpGrpcExporter - Failed to export ...。这些消息可能表明问题所在。

如果这不能解决问题，请使用 OTEL_ 命令描述容器组（pod），来转储并检查名称以 kubectl describe pod 开头的环境变量。

要启用 OpenTelemetry Python 调试日志记录，请将环境变量 OTEL_PYTHON_LOG_LEVEL 设置为 debug 并重新部署应用程序。

检查从 CloudWatch 代理导出数据的权限是否错误或不足。如果您在 CloudWatch 代理日志中看到 Access Denied 消息，则可能是问题所在。您安装 CloudWatch 代理时应用的权限后来可能被更改或撤销。

生成遥测数据时，请检查 Amazon Distro for OpenTelemetry（ADOT）问题。

确保检测注释 instrumentation.opentelemetry.io/inject-java 和 sidecar.opentelemetry.io/inject-java 已应用于应用程序部署，其值为 true。如果没有这些注释，即使 ADOT 附加组件安装正确，也不会对应用程序容器组（pod）进行检测。

接下来，检查 init 容器是否已应用于应用程序且 Ready 状态为 True。如果 init 容器未准备就绪，请查看状态以了解原因。

如果问题仍然存在，则请通过将环境变量 OTEL_JAVAAGENT_DEBUG 设置为 true 并重新部署应用程序来启用 OpenTelemetry Java SDK 的调试日志记录。然后查找以 ERROR io.telemetry 开头的消息。

指标/跨度导出程序可能正在删除数据。要找出答案，请查看应用程序日志中是否有包含 Failed to export... 的消息

向 Application Signals 发送指标或跨度时，CloudWatch 代理可能会受到限制。检查 CloudWatch 代理日志中是否有指示节流的消息。

确保您已启用服务发现设置。您只需在您的区域中执行一次此操作。

要进行确认，在 CloudWatch 控制台中，依次选择 Application Signals、服务。如果步骤 1 未标记为完成，则请选择开始发现您的服务。数据应在五分钟内开始流入。

UnknownService 表示检测的应用程序名称未知。如果 OTEL_SERVICE_NAME 环境变量未定义且未在 OTEL_RESOURCE_ATTRIBUTES 中指定 service.name，则服务名称将设置为 UnknownService。要解决此问题，请在 OTEL_SERVICE_NAME 或 OTEL_RESOURCE_ATTRIBUTES 中指定服务名称。

UnknownOperation 表示所调用的操作名称未知。当 Application Signals 无法发现调用远程调用的操作名称，或者提取的操作名称包含高基数值时，就会发生这种情况。

UnknownRemoteService 表示目标服务的名称未知。系统无法提取远程调用访问的目标服务名称时，就会发生这种情况。

一种解决方案是围绕发送请求的函数创建一个自定义跨度，然后添加具有指定值的属性 aws.remote.service。另一种选择是配置 CloudWatch 代理以自定义 RemoteService 的指标值。有关 CloudWatch 代理中自定义的更多信息，请参阅 启用 CloudWatch Application Signals。

UnknownRemoteOperation 表示目标操作的名称未知。系统无法提取远程调用访问的目标操作名称时，就会发生这种情况。

一种解决方案是围绕发送请求的函数创建一个自定义跨度，然后添加具有指定值的属性 aws.remote.operation。另一种选择是配置 CloudWatch 代理以自定义 RemoteOperation 的指标值。有关 CloudWatch 代理中自定义的更多信息，请参阅 启用 CloudWatch Application Signals。

启动时预加载：您的应用程序执行名为 loadDatafromDB 的操作，该操作在预热阶段从数据库中读取元数据。您不会将 loadDatafromDB 视为服务操作，而是将其归类为 InternalOperation。

后台异步执行：您的应用程序订阅事件队列，并在有更新时相应地处理流数据。每个触发的操作都将作为服务操作置于 InternalOperation 下。

从服务注册表检索主机信息：您的应用程序与服务注册表对话以进行服务发现。与发现系统的所有交互都归类为 InternalOperation。