对 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": {
>>>>>>> streams
  "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 容器未准备就绪，请查看状态以了解原因。

如果问题仍然存在，请执行以下操作，在 OpenTelemetry Java SDK 上启用调试日志记录。然后查找以 ERROR io.telemetry 开头的消息。

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

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

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