Monitorar eventos de serviço

O Service Events fornece observabilidade profunda automatizada para serviços monitorados com o CloudWatch Application Signals. Ele captura métricas de erro, dados de desempenho em nível de função, instantâneos de incidentes (quando as solicitações excedem os limites de latência ou lançam exceções) e eventos de implantação, sem alterações adicionais no código.

Como funcionam os eventos de serviço

O Service Events coleta os seguintes tipos de sinais de seus serviços instrumentados:

O Service Events é habilitado de maneira automática quando você habilita o CloudWatch Application Signals para seu serviço. As métricas de erro e o rastreamento de exceções são ativados de forma imediata. As métricas de chamada de função exigem configuração adicional — você deve configurar pacotes para instrumentar antes que os dados de chamada de função sejam coletados (veja Habilitar a instrumentação de funções). Os eventos de serviço podem ser desabilitados através da configuração OTEL_AWS_SERVICE_EVENTS_ENABLED=false. Os dados fluem do SDK ADOT para o agente do CloudWatch. O agente publica eventos no CloudWatch Logs (grupos de logs /aws/service-events/service-name) e no CloudWatch Metrics.

Linguagens com suporte: Java, Python e Node.js.

Armazenamento de dados

O Service Events armazena dados no CloudWatch Logs. O CloudWatch publica dados de eventos de serviço em um grupo de logs com o prefixo /aws/application-signals/service-name, em que service-name é o valor da sua variável de ambiente OTEL_SERVICE_NAME. Um grupo de logs é criado por serviço.

Você é cobrado pela ingestão e pelo armazenamento de logs de acordo com as taxas padrão do CloudWatch Logs.

Visualizar erros no console

No console do CloudWatch, navegue até Application Signals, escolha seu serviço e, em seguida, escolha a guia Errors. Essa guia mostra métricas de exceção para seu serviço.

A guia exibe:

Selecione uma exceção para detalhar as informações, incluindo o rastreamento de pilha, a mensagem de exceção e um link para o rastreamento associado.

Os erros são agrupados por operação, tipo de exceção e quadros de pilha superiores. Apenas o representante mais recente de cada grupo é mostrado.

Exibir eventos de serviço em logs

Os dados do Service Events são armazenados no CloudWatch Logs em grupos de logs com o prefixo /aws/service-events/service-name. É possível consultar esses dados diretamente usando o CloudWatch Logs Insights para criar visualizações personalizadas, criar painéis ou investigar incidentes específicos.

Para consultar eventos de serviço:

Eventos de serviço no servidor MCP (Model Context Protocol) do CloudWatch Application Signals

Os dados de eventos de serviço podem ser acessados por meio do servidor MCP (Model Context Protocol) do CloudWatch Application Signals, permitindo que assistentes e agentes de codificação de IA consultem diretamente o comportamento do runtime do seu serviço.

Solução de problemas do

Melhoria de performance

Para obter instruções de configuração e uso, veja o servidor MCP do Application Signals no site do GitHub.

Configurar eventos de serviço

Pré-requisitos

Para utilizar eventos de serviço, verifique se você tem as versões mínimas exigidas dos seguintes componentes:

Se você usa o Amazon EKS, veja Habilitar aplicações em clusters do Amazon EKS para obter instruções de configuração do complemento.

Os recursos são habilitados por padrão

Se você utiliza o CloudWatch Application Signals, os seguintes sinais de eventos de serviço são habilitados por padrão, sem necessidade de configuração adicional:

Os recursos mostrados a seguir são opcionais e exigem a configuração de variáveis de ambiente para produzir dados:

Configurações gerais

Habilitar a instrumentação de funções

A instrumentação de funções é habilitada por padrão, porém, não produz métricas até que você configure quais pacotes instrumentar. Forneça uma lista de permissões de pacotes para começar a coletar telemetria por função:

Filtragem de endpoints

A filtragem de endpoints controla quais endpoints geram métricas de erro de endpoint e instantâneos de incidentes. Essas configurações não afetam a instrumentação da função.

Limites de latência

Utilize as seguintes variáveis de ambiente para configurar os limites de latência para acionadores de instantâneos de incidentes.

Limitação de intervalo

Utilize as seguintes variáveis de ambiente para controlar a taxa na qual os dados de eventos de serviço são coletados e relatados.

Configurar eventos de implantação

Os eventos de implantação são sempre emitidos na inicialização do aplicativo e a cada 24 horas. O fornecimento de metadados de implantação enriquece esses eventos para que você possa correlacionar incidentes e alterações de desempenho com implantações de código específicas.

Defina as seguintes variáveis de ambiente em seus contêineres ou processos de aplicativos para fornecer metadados de implantação:

Configurar eventos de implantação com o GitHub Actions

No seu fluxo de trabalho do GitHub Actions, utilize as variáveis de ambiente integradas para preencher os metadados de implantação. Adicione o seguinte à sua etapa de implantação ou ambiente de contêiner:

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Se você implantar imagens de contêiner, transmita esses valores como variáveis de ambiente na definição da tarefa ou na especificação do pod. É possível incorporá-los à imagem no momento da criação ou injetá-los no momento da implantação através da sua configuração de implantação.

Configurar eventos de implantação com o GitLab CI/CD

Em seu pipeline de CI/CD do GitLab, utilize as variáveis predefinidas de CI/CD para preencher os metadados de implantação. Adicione o seguinte ao seu trabalho de implantação:

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

Passe essas variáveis para seus contêineres de aplicativos no momento da implantação através da sua plataforma de orquestração de contêineres (por exemplo, como variáveis de ambiente na definição de tarefas do Amazon ECS ou no manifesto de implantação do Kubernetes).