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

Monitoraggio della distribuzione dei dati

Utilizza questo argomento per scoprire come monitorare la tua consegna utilizzando Amazon CloudWatch Metrics, CloudWatch Logs e. AWS CloudTrail

CloudWatch metriche

Ogni consegna pubblica le metriche CloudWatch nel namespace. AWS/Kinesis I nomi delle metriche sono preceduti dal tipo di destinazione: DeliveryToS3 per le consegne generiche di Amazon S3 e per le DeliveryToIceberg consegne di tabelle di streaming. Utilizza questi parametri per monitorare lo stato e le prestazioni della tua distribuzione.

La tabella seguente elenca i parametri per le DeliveryToS3 consegne generiche di Amazon S3 ().

La tabella seguente elenca le metriche per lo streaming delle consegne delle tabelle (). DeliveryToIceberg

Dimensioni

Le metriche di consegna vengono pubblicate con le seguenti dimensioni:

Allarmi raccomandati

La tabella seguente elenca gli CloudWatch allarmi consigliati per le consegne.

CloudWatch Registri

Ogni consegna può pubblicare log dettagliati su Logs per il debug CloudWatch e la visibilità operativa.

Per impostazione predefinita, una consegna scrive nel seguente gruppo di log e flusso di log:

Abilitazione CloudWatch dei log tramite CLI

Abilita CloudWatch i registri durante la creazione o l'aggiornamento di una consegna utilizzando: AWS CLI

aws kinesis create-channel \
    --channel-name "my-channel" \
    --service-execution-role-arn "arn:aws:iam::111122223333:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:111122223333:stream/my-stream",
            "RecordConfiguration": { "RecordFormatType": "JSON" }
        }
    ]' \
    --s3-destination-configuration '{
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
            "ExpectedBucketOwner": "111122223333",
            "CompressionType": "GZIP"
        }
    }' \
    --logging-configuration '{
        "CloudWatchLogs": {
            "Enabled": true
        }
    }'

Quando abiliti CloudWatch i registri senza specificare un gruppo di log, la consegna utilizza il gruppo di log predefinito. /aws/kinesis/channelName/channelId Se specifichi un account personalizzatoLogGroupName, assicurati che le autorizzazioni CloudWatch Logs del ruolo di esecuzione del servizio rientrino nell'ambito dello stesso gruppo di log. Per le autorizzazioni richieste, consulta Autorizzazioni IAM per la consegna dei dati.

Puoi anche abilitare o aggiornare CloudWatch i registri su una consegna esistente con il update-channel comando, passando lo stesso valore. --logging-configuration

Autorizzazioni richieste

Per abilitare CloudWatch i registri, il ruolo di esecuzione del servizio della consegna deve disporre delle seguenti autorizzazioni:

Ambita queste autorizzazioni allo specifico gruppo di log ARN. Vedi Autorizzazioni opzionali per i log CloudWatch l'esempio completo della policy.

AWS CloudTrail logging

Tutte le chiamate API di consegna vengono registrate da AWS CloudTrail. Di seguito è riportato un esempio di AWS CloudTrail evento per una CreateChannel chiamata:

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA1EXAMPLE:user-session",
        "arn": "arn:aws:sts::<account-id>:assumed-role/<role-name>/user-session",
        "accountId": "<account-id>"
    },
    "eventTime": "2026-07-20T20:00:00Z",
    "eventSource": "kinesis.amazonaws.com",
    "eventName": "CreateChannel",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.1",
    "userAgent": "aws-cli/2.x",
    "requestParameters": {
        "streamName": "my-stream",
        "channelName": "my-channel"
    },
    "responseElements": {
        "channelARN": "arn:aws:kinesis:us-east-1:<account-id>:channel/<channel-id>"
    },
    "requestID": "a1b2c3d4-example",
    "eventID": "e5f6g7h8-example",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "<account-id>"
}