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

Usa questo argomento per scoprire come monitorare la spedizione utilizzando le CloudWatch metriche Amazon, CloudWatch i log 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 Amazon S3 a uso generico e per le consegne tramite tabelle in streaming. DeliveryToIceberg Usa queste metriche per monitorare lo stato e le prestazioni della tua consegna.

Dimensioni

Le metriche di consegna sono pubblicate con le seguenti dimensioni:

Allarmi raccomandati

CloudWatch Registri

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

Abilitazione CloudWatch dei log tramite CLI

Abilita CloudWatch i log 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::123456789012:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:123456789012:stream/my-stream",
            "RecordConfiguration": { "RecordFormatType": "JSON" }
        }
    ]' \
    --s3-destination-configuration '{
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::my-destination-bucket",
            "ExpectedBucketOwner": "123456789012",
            "CompressionType": "GZIP"
        }
    }' \
    --logging-configuration '{
        "CloudWatchLogs": {
            "Enabled": true
        }
    }'

Quando abiliti CloudWatch i log senza specificare un gruppo di log, la consegna utilizza il gruppo /aws/kinesis/channelName/channelId di log predefinito. Se specifichi un valore personalizzatoLogGroupName, assicurati che le autorizzazioni CloudWatch Logs del ruolo di esecuzione del servizio siano limitate allo stesso gruppo di log. Per le autorizzazioni richieste, consulta Autorizzazioni IAM per la distribuzione dei dati.

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

Autorizzazioni richieste

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

Assegnate queste autorizzazioni allo specifico gruppo di log ARN. Vedi Autorizzazioni opzionali per i log CloudWatch per 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>"
}