Usar o agente do CloudWatch com a telemetria relacionada - Amazon CloudWatch

Usar o agente do CloudWatch com a telemetria relacionada

As métricas e os logs enviados ao CloudWatch podem incluir uma entidade opcional para correlacionar a telemetria. As entidades são usadas no painel Analisar dados relacionados. O agente do CloudWatch envia entidades com um nome de serviço e um nome de ambiente incluídos.

O agente escolhe o nome do serviço e o nome do ambiente dos dados a seguir.

Nome do serviço

O agente escolhe o nome do serviço nas seguintes opções, em ordem de prioridade:

  • Instrumentação do Application Signals: o agente envia o nome do serviço usado pelo Application Signals. Isso pode ser sobrescrito alterando a variável OTEL_SERVICE_NAME de ambiente usada pelas bibliotecas de instrumentação compatíveis do OpenTelemetry.

  • Configuração do agente do CloudWatch: você pode configurar o agente para usar um nome de serviço específico. Isso pode ser configurado no nível do agente, do plug-in, de métricas, logs ou de arquivo de logs.

  • Nome da workload do Kubernetes: em workloads do Kubernetes, o agente envia o nome da workload para o pod correspondente, na ordem de prioridade a seguir.

    • Nome da implantação

    • Nome de ReplicaSet

    • Nome de StatefulSet

    • Nome de DaemonSet

    • Nome de CronJob

    • Nome do trabalho

    • Nome do pod

    • Nome do contêiner

  • Tags de recursos de metadados da instância: para workloads do Amazon EC2, o agente envia um nome de tags, na ordem a seguir.

    • serviço

    • aplicação

    • aplicação

    Você deve configurar os metadados da instância para que o agente possa acessar as tags.

  • Padrão: se nenhum outro nome de serviço for encontrado, o agente enviará o nome Unknown.

Nome do ambiente

O agente escolhe o nome do ambiente entre as seguintes opções, em ordem de prioridade:

  • Instrumentação do Application Signals: o agente envia o nome do ambiente usado pelo Application Signals. Isso pode ser sobrescrito definindo uma variável deployment.environment de ambiente usada pelas bibliotecas de instrumentação compatíveis do OpenTelemetry. Por exemplo, as aplicações podem definir a variável OTEL_RESOURCE_ATTRIBUTES=deployment.environment=MyEnvironment de ambiente.

  • Configuração do agente CloudWatch: você pode configurar o agente para usar um nome de ambiente específico. Isso pode ser configurado no nível do agente, do plug-in, de métricas, logs ou de arquivo de logs.

  • Espaço de trabalho e nome do cluster: para o Amazon EKS, eks:cluster-name/Namespace. Para o Kubernetes nativo em execução no Amazon EC2, k8s:cluster-name/Namespace.

  • Tags de recursos dos metadados da instância: para workloads do Amazon EC2, o agente pode usar a tag AutoScalingGroup.

    Você deve configurar os metadados da instância para que o agente possa acessar as tags.

  • Por padrão, as instâncias do Amazon EC2 que não estão executando o Kubernetes receberão o nome de ambiente ec2:default.