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

Registros e métricas vendidas

Você pode monitorar seus espaços de agentes e operações de serviço usando CloudWatch métricas e registros vendidos pela Amazon. Este tópico descreve as CloudWatch métricas que o AWS DevOps Agente publica automaticamente em sua conta e os registros vendidos que você pode configurar para entrega em seus destinos preferidos.

Métricas vendidas CloudWatch

AWS DevOps O agente publica automaticamente métricas CloudWatch na Amazon em sua conta. Essas métricas estão disponíveis sem nenhuma configuração. Você pode usá-los para monitorar o uso, rastrear a atividade operacional e criar alarmes.

Perfil vinculado ao serviço

Para que CloudWatch as métricas da Amazon sejam publicadas em sua conta para esse serviço, o AWS DevOps agente criará automaticamente a função vinculada ao serviço AWSServiceRoleForAIDevOps Service-Linked Role para você. Se a função do IAM que invoca a API não tiver a permissão apropriada, a criação do recurso falhará com um InvalidParameterException.

Crie manualmente uma função vinculada ao serviço (para clientes existentes)

Execute um destes procedimentos:

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

Namespace

Todas as métricas são publicadas no AWS/AIDevOps namespace.

Dimensões

Todas as métricas incluem a seguinte dimensão.

Referência de métricas

Visualizando métricas no CloudWatch console

Pré-requisitos

Antes de configurar a entrega de registros, verifique se você tem o seguinte:

Logs fornecidos

AWS DevOps O agente oferece suporte a registros vendidos que fornecem visibilidade dos eventos que seus espaços de agentes e registros de serviços processam. Os registros vendidos usam a infraestrutura Amazon CloudWatch Logs para entregar os registros ao seu destino preferido.

Para usar registros vendidos, você deve configurar um destino de entrega. Os seguintes destinos são compatíveis:

Tipos de log compatíveis

Um único tipo de log é suportado:APPLICATION_LOGS. Esse tipo de registro abrange todos os eventos operacionais que o serviço emite.

Registrar tipos de eventos

A tabela a seguir resume os eventos que o AWS DevOps Agente registra.

Permissões

AWS DevOps O agente usa registros CloudWatch vendidos (permissões V2) para entregar registros. Para configurar a entrega de registros, a função do IAM que configura a entrega deve ter as seguintes permissões:

Para ver a política completa do IAM que é necessária para cada tipo de destino, consulte os seguintes tópicos no Guia do usuário do Amazon CloudWatch Logs:

Configurar a entrega de registros (console)

AWS DevOps O agente fornece dois locais no console AWS de gerenciamento para configurar a entrega de registros:

Para configurar a entrega de registros para um registro de serviço

Para configurar a entrega de registros para um espaço de agente

Configurar a entrega de registros (CloudWatch API)

Você também pode usar a API CloudWatch Logs para configurar a entrega de registros de forma programática. A entrega de um log de trabalho consiste em três elementos:

Etapa 1: criar uma fonte de entrega

Use a PutDeliverySourceoperação para criar uma fonte de entrega. Passe o ARN do seu recurso de espaço do AWS DevOps agente e especifique APPLICATION_LOGS como o tipo de registro.

O exemplo a seguir cria uma fonte de entrega para um espaço de agente:

{
    "name": "my-agent-space-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id",
    "logType": "APPLICATION_LOGS"
}

O exemplo a seguir cria uma fonte de entrega para o serviço:

{
    "name": "my-service-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service",
    "logType": "APPLICATION_LOGS"
}

Etapa 2: criar um destino de entrega

Use a PutDeliveryDestinationoperação para configurar onde os registros são armazenados. Você pode escolher Amazon CloudWatch Logs, Amazon S3 ou Amazon Data Firehose.

O exemplo a seguir cria um destino de CloudWatch registros:

{
    "name": "my-cwl-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space"
    },
    "outputFormat": "json"
}

O exemplo a seguir cria um destino do Amazon S3:

{
    "name": "my-s3-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket"
    },
    "outputFormat": "json"
}

O exemplo a seguir cria um destino do Amazon Data Firehose:

{
    "name": "my-firehose-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream"
    },
    "outputFormat": "json"
}

Se você quiser usar CloudFormation, você pode usar o seguinte:

ResourceArn é AgentSpaceArn, e LogType deve ser APPLICATION_LOGS como o tipo de log compatível.

Etapa 3: criar uma entrega

Use a CreateDeliveryoperação para vincular a origem da entrega ao destino da entrega.

{
    "deliverySourceName": "my-agent-space-delivery-source",
    "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination"
}

AWS CloudFormation

Você também pode configurar a entrega de registros usando AWS CloudFormation os seguintes recursos:

ResourceArnDefina o espaço do AWS DevOps agente ou o ARN do serviço e LogType defina como. APPLICATION_LOGS

Registro da referência de esquemas

AWS DevOps O agente usa um esquema de log compartilhado em todos os tipos de eventos. Nem todo evento de log usa todos os campos.

A tabela a seguir descreve os campos no esquema de log.

Gerenciar e desativar a entrega de registros

Você pode modificar ou remover a entrega de registros a qualquer momento no console do AWS DevOps agente no AWS Management Console ou usando a API de CloudWatch registros.

Gerenciar a entrega de registros (console)

Desativar a entrega de registros (console)

Desativar a entrega de registros (API)

Para remover uma entrega de registros usando a API, exclua os recursos na seguinte ordem:

Preços

O AWS DevOps agente não cobra pela ativação de registros vendidos. Entretanto, você pode incorrer em cobranças pela entrega, ingestão, armazenamento ou acesso, dependendo do destino de entrega de log selecionado. Para obter detalhes sobre preços, consulte Vended Logs na guia Logs em Amazon CloudWatch Pricing.

Para preços específicos do destino, consulte o seguinte: