As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitoramento da entrega de dados

Use este tópico para saber como monitorar sua entrega usando CloudWatch métricas, CloudWatch registros AWS CloudTrail e.

CloudWatch métricas

Cada entrega publica métricas CloudWatch no AWS/Kinesis namespace. Os nomes das métricas são prefixados por tipo de destino: DeliveryToS3 para entregas do Amazon S3 de uso geral e DeliveryToIceberg para entregas de tabelas de streaming. Use essas métricas para monitorar a saúde e o desempenho de sua entrega.

Dimensões

As métricas de entrega são publicadas com as seguintes dimensões:

Alarmes recomendados

CloudWatch Registros

Cada entrega pode publicar registros detalhados no CloudWatch Logs para depuração e visibilidade operacional.

Habilitando CloudWatch registros via CLI

Ative CloudWatch os registros ao criar ou atualizar uma entrega usando 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 você ativa CloudWatch os registros sem especificar um grupo de registros, a entrega usa o grupo /aws/kinesis/channelName/channelId de registros padrão. Se você especificar uma personalizaçãoLogGroupName, certifique-se de que as permissões de CloudWatch registros da função de execução do serviço tenham como escopo o mesmo grupo de registros. Para ver as permissões necessárias, consulte Permissões do IAM para entrega de dados.

Você também pode ativar ou atualizar CloudWatch os registros em uma entrega existente com o update-channel comando, transmitindo o mesmo --logging-configuration valor.

Permissões obrigatórias

Para ativar o CloudWatch Logs, a função de execução do serviço de entrega deve ter as seguintes permissões:

Defina o escopo dessas permissões para o ARN específico do grupo de registros. Veja o Permissões CloudWatch de registros opcionais exemplo completo da política.

AWS CloudTrail registro em log

Todas as chamadas da API de entrega são gravadas por AWS CloudTrail. Veja a seguir um exemplo de AWS CloudTrail evento para uma CreateChannel chamada:

{
    "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>"
}