Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitora gli eventi di servizio

Service Events fornisce un'osservabilità approfondita automatizzata per i servizi monitorati con Application Signals. CloudWatch Acquisisce metriche di errore, dati sulle prestazioni a livello di funzione, istantanee degli incidenti (quando le richieste superano le soglie di latenza o generano eccezioni) ed eventi di distribuzione, senza ulteriori modifiche al codice.

Come funzionano gli eventi di servizio

Service Events raccoglie i seguenti tipi di segnali dai servizi strumentati:

Service Events viene abilitato automaticamente quando abiliti Application Signals per il tuo servizio. CloudWatch Le metriche degli errori e il monitoraggio delle eccezioni sono attivi immediatamente. Function-call le metriche richiedono una configurazione aggiuntiva: è necessario configurare i pacchetti in base allo strumento prima di raccogliere i dati sulle chiamate di funzione (vedere). Abilita la strumentazione funzionale Gli eventi di servizio possono essere disabilitati impostando. OTEL_AWS_SERVICE_EVENTS_ENABLED=false Flussi di dati dall'ADOT SDK all' CloudWatch agente. L'agente pubblica gli eventi CloudWatch nei log (/aws/service-events/service-namegruppi di log) e nelle metriche. CloudWatch

Linguaggi supportati: Java, Python e. Node.js

Archiviazione di dati

Service Events memorizza i dati nei CloudWatch log. CloudWatch pubblica i dati degli eventi di servizio in un gruppo di log con il prefisso/aws/application-signals/service-name, dove service-name è il valore della variabile di OTEL_SERVICE_NAME ambiente. Viene creato un gruppo di log per servizio.

L'inserimento e l'archiviazione dei log vengono fatturati alle tariffe standard CloudWatch dei log.

Visualizza gli errori nella console

Nella CloudWatch console, vai su Application Signals, scegli il tuo servizio, quindi scegli la scheda Errori. Questa scheda mostra le metriche delle eccezioni per il tuo servizio.

La scheda mostra:

Seleziona un'eccezione per approfondire i dettagli, tra cui la traccia dello stack, il messaggio di eccezione e un collegamento alla traccia associata.

Gli errori sono raggruppati per operazione, tipo di eccezione e frame principali dello stack. Viene mostrato solo il rappresentante più recente di ciascun gruppo.

Visualizza gli eventi di servizio nei registri

I dati degli eventi di servizio vengono archiviati nei CloudWatch registri in gruppi di log con il prefisso/aws/service-events/service-name. Puoi interrogare questi dati direttamente utilizzando CloudWatch Logs Insights per creare visualizzazioni personalizzate, creare dashboard o indagare su incidenti specifici.

Per interrogare gli eventi del servizio:

Eventi di servizio nel server MCP (Model Context Protocol) di CloudWatch Application Signals

I dati sugli eventi di servizio sono accessibili tramite il server CloudWatch Application Signals MCP (Model Context Protocol), che consente agli assistenti e agli agenti di codifica AI di interrogare direttamente il comportamento di runtime del servizio.

Risoluzione dei problemi

Miglioramento delle prestazioni

Per le istruzioni di configurazione e utilizzo, consulta il server MCP Application Signals sul sito Web. GitHub

Configurare gli eventi di servizio

Prerequisiti

Per utilizzare gli eventi di servizio, assicurati di disporre delle versioni minime richieste dei seguenti componenti:

Se usi Amazon EKS, consulta le istruzioni Abilitazione delle applicazioni sui cluster Amazon EKS per la configurazione del componente aggiuntivo.

Funzionalità abilitate per impostazione predefinita

Se si utilizzano CloudWatch Application Signals, i seguenti segnali di eventi di servizio sono abilitati per impostazione predefinita senza necessità di ulteriori configurazioni:

Le seguenti funzionalità sono opzionali e richiedono l'impostazione di variabili di ambiente per produrre dati:

Impostazioni generali

Abilita la strumentazione funzionale

La strumentazione delle funzioni è abilitata per impostazione predefinita, ma non produce metriche finché non si configura quali pacchetti utilizzare. Fornisci un elenco dei pacchetti consentiti per iniziare a raccogliere la telemetria per funzione:

Filtraggio degli endpoint

Il filtro degli endpoint controlla quali endpoint generano le metriche di errore degli endpoint e le istantanee degli incidenti. Queste impostazioni non influiscono sulla strumentazione delle funzioni.

Soglie di latenza

Utilizzate le seguenti variabili di ambiente per configurare le soglie di latenza per i trigger delle istantanee degli incidenti.

Limitazione della velocità

Utilizza le seguenti variabili di ambiente per controllare la velocità con cui i dati sugli eventi di servizio vengono raccolti e segnalati.

Configurare gli eventi di distribuzione

Gli eventi di distribuzione vengono sempre emessi all'avvio dell'applicazione e ogni 24 ore. La fornitura di metadati di distribuzione arricchisce questi eventi in modo da poter correlare incidenti e modifiche delle prestazioni con distribuzioni di codice specifiche.

Imposta le seguenti variabili di ambiente nei contenitori o nei processi dell'applicazione per fornire i metadati di distribuzione:

Configura gli eventi di distribuzione con Actions GitHub

Nel flusso di lavoro di GitHub Actions, utilizza le variabili di ambiente integrate per popolare i metadati di distribuzione. Aggiungi quanto segue alla fase di distribuzione o all'ambiente del contenitore:

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 distribuisci immagini di container, passa questi valori come variabili di ambiente nella definizione dell'attività o nelle specifiche del pod. Puoi inserirli nell'immagine in fase di compilazione o inserirli in fase di distribuzione tramite la configurazione di distribuzione.

Configura gli eventi di distribuzione con GitLab CI/CD

Nella GitLab CI/CD pipeline, utilizza le CI/CD variabili predefinite per popolare i metadati di distribuzione. Aggiungi quanto segue al tuo processo di distribuzione:

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

Passa queste variabili ai contenitori delle applicazioni in fase di distribuzione tramite la tua piattaforma di orchestrazione dei container (ad esempio, come variabili di ambiente nella definizione delle attività di Amazon ECS o nel manifesto di distribuzione Kubernetes).