View a markdown version of this page

Creazione di pipeline - Amazon CloudWatch
Creazione di una pipeline di logCreazione di una pipeline di metriche

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

Creazione di pipeline

CloudWatch pipelines supporta la creazione di pipeline sia per i log che per i dati delle metriche. Le sezioni seguenti descrivono come creare ogni tipo di pipeline.

Creazione di una pipeline di log

La procedura guidata di configurazione della pipeline ti guida nella creazione della pipeline di dati dei log.

  1. In Impostazioni generali, fornisci i dettagli dell'origine dati, inclusi il nome e il tipo della fonte. Puoi anche specificare i tag della pipeline e il nome della pipeline.

  2. In Destinazione, specifica i dettagli della destinazione. Per le pipeline di log, CloudWatch Logs è l'unica destinazione supportata. Per le pipeline di metriche, CloudWatch Metrics è l'unica destinazione supportata.

  3. In Processore, aggiungi i processori e i parser desiderati. Un parser è un primo passaggio obbligatorio per determinati tipi di dati. È possibile eseguire analisi personalizzate utilizzando processori come Grok o CSV. Puoi utilizzare il processore di ricerca per arricchire gli eventi di log con i dati di una tabella di ricerca di Amazon CloudWatch Logs. I processori che non sono supportati dal tipo di dati sono disabilitati.

    Per configurare i processori utilizzando il linguaggio naturale, abilita l'AI-assistedinterruttore. Immettete una descrizione delle trasformazioni di log necessarie e CloudWatch Pipeline genererà automaticamente la configurazione del processore. Per i AWS log venduti, viene inoltre generato un evento di registro di esempio in modo da poter verificare l'output prima della distribuzione. È possibile rivedere e modificare la configurazione generata prima di creare la pipeline.

    Importante

    Per utilizzare la configurazione AI-assisted del processore, è necessario disporre dell'autorizzazione logs:GeneratePipeline IAM. Per ulteriori informazioni, consulta AI-assisted autorizzazioni di configurazione del processore.

    È inoltre possibile aggiungere regole di elaborazione condizionale ai processori supportati utilizzando il when parametro. L'elaborazione condizionale consente di controllare su quali voci di registro agisce un processore. Per la sintassi delle espressioni e i processori supportati, vedere. Sintassi delle espressioni per l'elaborazione condizionale

    Per conservare copie non modificate dei dati di registro per scopi di controllo o conformità, abilita l'opzione Mantieni il registro originale. Se abilitato, CloudWatch pipelines archivia automaticamente una copia di ogni evento di registro non elaborato prima che avvenga qualsiasi trasformazione nel campo di @original_message sistema dell'evento. Ciò garantisce che i dati originali siano sempre disponibili per controlli o indagini, anche dopo che i processori hanno modificato gli eventi del registro. L'opzione Keep original log è disponibile solo per le pipeline con una fonte di log fornita. CloudWatch

  4. In Rivedi e crea, esamina la configurazione della pipeline. Se sei soddisfatto della configurazione, scegli Crea pipeline per avviare la distribuzione e la creazione di risorse della pipeline. Il completamento della creazione della pipeline richiede fino a 5 minuti a seconda del tipo di origine. Al termine, verrai indirizzato alla scheda Pipelines nella Ingestion Console.

Importante

Le configurazioni dei processori Pipeline vengono registrate negli AWS CloudTrail eventi per scopi di controllo e conformità. Per proteggere le informazioni riservate, non includete password, chiavi API o altre informazioni sensibili nelle configurazioni del processore.

Creazione di una pipeline di metriche

Puoi creare una pipeline di metriche utilizzando la CloudWatch console o la AWS CLI. Con una pipeline di metriche, puoi elaborare i dati delle CloudWatch metriche, applicare trasformazioni e inoltrare le metriche elaborate a. CloudWatch

Per creare una pipeline di metriche (console)

Utilizzate la procedura seguente per creare una pipeline di metriche nella console. CloudWatch

  1. Apri la CloudWatch console e nel pannello di navigazione, scegli Ingestion, Pipelines.

  2. Scegliere Create pipeline (Crea pipeline).

  3. Per il tipo di sorgente, seleziona CloudWatch Metrics (OTel).

  4. Configura i criteri di selezione per specificare le metriche elaborate dalla pipeline. I criteri di selezione utilizzano percorsi di attributi OTel come resource.attributesmetric.name, e. datapoint.attributes Tutti i criteri utilizzano la semantica AND (tutti devono corrispondere).

  5. In Processore, aggiungi fino a 20 processori per trasformare i dati delle metriche.

  6. In Rivedi e crea, esamina la configurazione della pipeline e scegli Crea pipeline.

Per creare una pipeline di metriche (AWS CLI)

Utilizzate il create-telemetry-pipeline comando per creare una pipeline di metriche dalla CLI AWS .

aws observabilityadmin create-telemetry-pipeline \
    --pipeline-configuration-body file://config.yaml

L'esempio seguente mostra un file di configurazione YAML che definisce una pipeline di metriche con sorgente, processore e sink.

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "payment-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}

Quando la pipeline viene creata, restituisce un ARN nel seguente formato:

arn:aws:observabilityadmin:region:accountId:telemetry-pipeline/pipelineID
Nota

CloudWatch Metrics è l'unica destinazione supportata per le pipeline di metriche.

Operazioni API supportate

La tabella seguente elenca le operazioni API che è possibile utilizzare per gestire le pipeline di metriche.

Operation Description
CreateTelemetryPipeline Crea una nuova pipeline di metriche.
GetTelemetryPipeline Recupera i dettagli su una pipeline di metriche specifica.
ListTelemetryPipelines Elenca tutte le pipeline di metriche presenti nel tuo account.
DeleteTelemetryPipeline Elimina una pipeline di metriche.
ValidateTelemetryPipelineConfiguration Convalida la configurazione di una pipeline prima della creazione.
UpdateTelemetryPipeline Aggiorna una configurazione esistente della pipeline di metriche.