Abilita CloudWatch Application Signals - Amazon CloudWatch

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à.

Abilita CloudWatch Application Signals

Utilizzate CloudWatch Application Signals per strumentare automaticamente le vostre applicazioni AWS in modo da monitorare le prestazioni delle applicazioni rispetto agli obiettivi aziendali. Application Signals offre una visione unificata e incentrata sulle applicazioni delle applicazioni Java, delle loro dipendenze e dei loro edge. Per ulteriori informazioni, consulta Application Signals.

CloudWatch Application Signals sfrutta l' CloudWatch agente per ricevere metriche e tracce dalle applicazioni con strumentazione automatica, applicare facoltativamente regole per ridurre la cardinalità elevata e quindi pubblicare la telemetria elaborata su. CloudWatch È possibile fornire una configurazione personalizzata all' CloudWatch agente specificamente per Application Signals utilizzando il file di configurazione dell'agente. Innanzitutto, la presenza di una application_signals sezione sotto la sezione all'interno della metrics_collected sezione del logs file di configurazione dell'agente specifica che l' CloudWatch agente riceverà le metriche dalle applicazioni con strumentazione automatica. Allo stesso modo, la presenza di una application_signals sezione sotto la traces_collected sezione all'interno della traces sezione del file di configurazione dell'agente specifica che l' CloudWatch agente è abilitato a ricevere tracce dalle applicazioni con strumentazione automatica. Inoltre, puoi facoltativamente inoltrate regole di configurazione personalizzate per ridurre la pubblicazione di telemetria ad alta cardinalità, come indicato in questa sezione.

  • Per i cluster Amazon EKS, quando installi il componente aggiuntivo Amazon CloudWatch Observability EKS, l' CloudWatch agente è abilitato per impostazione predefinita a ricevere sia metriche che tracce dalle tue applicazioni con strumentazione automatica. Se desideri facoltativamente inoltrare regole di configurazione personalizzate, puoi farlo inoltrando una configurazione dell'agente personalizzata al componente aggiuntivo Amazon EKS quando lo crei o lo aggiorni utilizzando una configurazione aggiuntiva, come indicato in (Facoltativo) Configurazione aggiuntiva.

  • Per RedHat for OpenShift on AWS (ROSA), quando si installa l'operatore dell' CloudWatch agente utilizzando helm chart, l' CloudWatch agente è abilitato per impostazione predefinita a ricevere sia metriche che tracce dalle applicazioni con strumentazione automatica. Se desideri passare facoltativamente regole di configurazione personalizzate, puoi farlo passando una configurazione personalizzata dell'agente utilizzando il diagramma di Helm, come indicato in (Facoltativo) [Configurazione aggiuntiva], come indicato in. (Facoltativo) Configurazione aggiuntiva

  • Per altre piattaforme supportate, tra cui Amazon EC2, è necessario avviare l' CloudWatch agente con una configurazione dell'agente che abiliti Application Signals specificando le application_signals sezioni e, facoltativamente, eventuali regole di configurazione personalizzate, come descritto più avanti in questa sezione.

Di seguito è riportata una panoramica dei campi del file di configurazione dell' CloudWatch agente relativi ad CloudWatch Application Signals.

  • logs

    • metrics_collected— Questo campo può contenere sezioni per specificare che l'agente deve raccogliere i log per abilitare casi d'uso come CloudWatch Application Signals e Container Insights con osservabilità migliorata per Amazon EKS.

      Nota

      In precedenza, questa sezione veniva utilizzata anche per specificare che l'agente deve raccogliere i log con formato del parametro incorporato. Queste impostazioni non sono più necessarie.

      • application_signals(Facoltativo) Specificate che desiderate abilitare CloudWatch Application Signals a ricevere metriche dalle vostre applicazioni con strumentazione automatica per facilitare i segnali applicativi. CloudWatch

        • rules (Facoltativo) Una serie di regole per selezionare parametri e tracce in modo condizionale e applicare azioni per gestire scenari ad alta cardinalità. Ogni regola può contenere i seguenti campi:

          • rule_name (Facoltativo) Il nome della regola.

          • selectors (Facoltativo) Una serie di corrispondenze tra le dimensioni di parametri e tracce. Ogni selettore deve fornire i campi riportati di seguito:

            • dimension Obbligatorio se selectors non è vuoto. Questo specifica la dimensione delle metriche e delle tracce da utilizzare come filtro.

            • match Obbligatorio se selectors non è vuoto. Un modello jolly utilizzato per i valori corrispondenti della dimensione specificata.

          • action (Facoltativo) L'operazione da applicare ai parametri e alle tracce che corrispondono ai selettori specificati. action deve essere una delle seguenti parole chiave.

            • keepSpeciifica di inviare solo le metriche e le tracce a, CloudWatch se corrisponde a. selectors

            • drop Specifica di eliminare il parametro e le tracce che corrispondono ai selectors.

            • replace Specifica di sostituire le dimensioni dei parametri e delle tracce che corrispondono ai selectors. Le sostituzioni sono effettuate in base alla sezione replacements.

          • replacements Obbligatorio se action è replace. Una serie di coppie di dimensioni e valori che verranno applicate a parametri e tracce che corrispondono ai selectors specificati quando action è replace. Ogni sostituzione deve fornire i campi riportati di seguito:

            • target_dimension Obbligatorio se replacements non è vuoto. Specifica la dimensione che deve essere sostituita.

            • value Obbligatorio se replacements non è vuoto. Il valore con cui sostituire il valore originale di target_dimension.

        • limiter(Facoltativo) Utilizzate questa sezione per limitare il numero di metriche e dimensioni a cui vengono inviate Application Signals CloudWatch, per ottimizzare i costi.

          • disabled(Facoltativo) Setrue, la funzione di limitazione delle metriche è disabilitata. Il valore predefinito è false.

          • drop_threshold(Facoltativo) Il numero massimo di metriche distinte per servizio in un intervallo di rotazione che possono essere esportate da un agente. CloudWatch L'impostazione predefinita è 500.

          • rotation_interval(Facoltativo) L'intervallo in base al quale il limitatore reimposta i record metrici per il conteggio delle distinzioni. Viene espresso come una stringa con una sequenza di numeri e un suffisso unitario. Le frazioni sono supportate. I suffissi di unità supportati sonos,,, mh, e ms us ns

            L'impostazione predefinita è 1h un'ora.

          • log_dropped_metrics(Facoltativo) Speciifica se l'agente deve scrivere i log nei log dell' CloudWatch agente quando le metriche di Application Signals vengono eliminate. Il valore predefinito è false.

            Nota

            Per attivare questa registrazione, il debug parametro nella agent sezione deve essere impostato anche su. true

  • traces

    • traces_collected

      • application_signals Facoltativo. Specificalo per consentire all' CloudWatch agente di ricevere tracce dalle tue applicazioni con strumentazione automatica per facilitare CloudWatch i segnali applicativi.

Nota

Anche se le regole application_signals personalizzate sono specificate nella sezione metrics_collected contenuta nella sezione logs, si applicano implicitamente anche alla sezione traces_collected. Lo stesso insieme di regole si applicherà sia ai parametri che alle tracce.

Quando sono presenti più regole con operazioni diverse, queste si applicano nella seguente sequenza: keep, poi drop, quindi replace.

Di seguito è riportato un esempio di file di configurazione completo CloudWatch dell'agente che applica regole personalizzate.

{
  "logs": {
    "metrics_collected": {
      "application_signals": {
        "rules": [
          {
            "rule_name": "keep01",
            "selectors": [
              {
                "dimension": "Service",
                "match": "pet-clinic-frontend"
              },
              {
                "dimension": "RemoteService",
                "match": "customers-service"
              }
            ],
            "action": "keep"
          },
          {
            "rule_name": "drop01",
            "selectors": [
              {
                "dimension": "Operation",
                "match": "GET /api/customer/owners/*"
              }
            ],
            "action": "drop"
          },
          {
            "rule_name": "replace01",
            "selectors": [
              {
                "dimension": "Operation",
                "match": "PUT /api/customer/owners/*/pets/*"
              },
              {
                "dimension": "RemoteOperation",
                "match": "PUT /owners"
              }
            ],
            "replacements": [
              {
                "target_dimension": "Operation",
                "value": "PUT /api/customer/owners/{ownerId}/pets{petId}"
              }
            ],
            "action": "replace"
          }
        ]
      }
    }
  },
  "traces": {
    "traces_collected": {
      "application_signals": {}
    }
  }
}

Per il file di configurazione di esempio precedente, le rules vengono elaborate come segue:

  1. La regola keep01 assicura che tutte i parametri e le tracce con la dimensione Service come pet-clinic-frontend e la dimensione RemoteService come customers-service vengano mantenute.

  2. Per i parametri e le tracce elaborati dopo l'applicazione di keep01, la regola drop01 garantisce che i parametri e le tracce con la dimensione Operation come GET /api/customer/owners/* vengano eliminati.

  3. Per i parametri e le tracce elaborati dopo l'applicazione di drop01, la regola replace01 aggiorna i parametri e le tracce che hanno la dimensione Operation come PUT /api/customer/owners/*/pets/* e la dimensione RemoteOperation come PUT /owners in modo che la dimensione Operation venga ora sostituita da PUT /api/customer/owners/{ownerId}/pets{petId}.

Di seguito è riportato un esempio completo di file di CloudWatch configurazione che gestisce la cardinalità in Application Signals modificando il limite delle metriche su 100, abilitando la registrazione delle metriche eliminate e impostando l'intervallo di rotazione su due ore.

{
    "logs": {
        "metrics_collected": {
            "application_signals": {
                "limiter": {
                    "disabled": false,
                    "drop_threshold": 100,
                    "rotation_interval": "2h",
                    "log_dropped_metrics": true
                }
            }
        },
        "traces": {
            "traces_collected": {
                "application_signals": {}
            }
        }
    }
}