

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
<a name="CloudWatch-Agent-Application_Signals"></a>

Usa CloudWatch Application Signals per strumentare automaticamente le tue applicazioni AWS in modo da monitorare le prestazioni delle applicazioni rispetto ai tuoi 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 [Segnali applicativi](CloudWatch-Application-Monitoring-Sections.md).

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](install-CloudWatch-Observability-EKS-addon.md) 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](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration).
+ 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 facoltativamente inoltrare regole di configurazione personalizzate, puoi farlo inoltrando una configurazione dell'agente personalizzata al grafico Helm, come indicato in [(Facoltativo) Configurazione aggiuntiva](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration).
+ 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 Application Signals. CloudWatch 
+ `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.
          + `keep`Speciifica di inviare solo le metriche e le tracce a, se corrisponde a. CloudWatch `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) Se `true`, la funzionalità 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 delle metriche per il conteggio delle distinzioni. Viene espresso sotto forma di una stringa con una sequenza di numeri e un suffisso di unità. Le frazioni sono supportate. I suffissi di unità supportati sono`s`,,`m`, `h` `ms``us`, e. `ns` Il valore predefinito è `1h` per 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, anche il parametro `debug` nella sezione `agent` deve essere impostato su `true`.
+ `traces`
  + `traces_collected`
    + `application_signals` Facoltativo. Specificalo per consentire all' CloudWatchagente 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.

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

1. 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 a 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": {}
            }
        }
    }
}
```