Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Logs et statistiques vendus

Vous pouvez surveiller les espaces de vos agents et les opérations de service en utilisant les CloudWatch statistiques et les journaux Amazon vendus. Cette rubrique décrit les CloudWatch métriques que l' AWS DevOps agent publie automatiquement sur votre compte et les journaux vendus que vous pouvez configurer pour la livraison vers vos destinations préférées.

Indicateurs vendus CloudWatch

AWS DevOps L'agent publie automatiquement les statistiques sur Amazon CloudWatch dans votre compte. Ces métriques sont disponibles sans aucune configuration. Vous pouvez les utiliser pour surveiller l'utilisation, suivre l'activité opérationnelle et créer des alarmes.

Rôle lié à un service

Pour que CloudWatch les statistiques Amazon soient publiées sur votre compte pour ce service, l' AWS DevOps agent créera automatiquement le rôle lié au service AWSServiceRoleForAIDevOps Service-Linked Role pour vous. Si le rôle IAM invoquant l'API ne dispose pas de l'autorisation appropriée, la création de la ressource échouera avec un. InvalidParameterException

Créer manuellement un rôle lié à un service (pour les clients existants)

Effectuez l’une des actions suivantes :

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

Namespace

Toutes les métriques sont publiées dans l'espace de AWS/AIDevOps noms.

Dimensions

Toutes les mesures incluent la dimension suivante.

Référence des métriques

Afficher les métriques dans la CloudWatch console

Conditions préalables

Avant de configurer la livraison des journaux, assurez-vous que vous disposez des éléments suivants :

Journaux vended

AWS DevOps L'agent prend en charge les journaux vendus qui fournissent une visibilité sur les événements traités par vos espaces d'agent et les enregistrements de services. Les journaux automatiques utilisent l'infrastructure Amazon CloudWatch Logs pour acheminer les journaux vers votre destination préférée.

Pour utiliser les journaux vendus, vous devez configurer une destination de livraison. Les destinations suivantes sont prises en charge :

Types de journaux pris en charge

Un seul type de journal est pris en charge :APPLICATION_LOGS. Ce type de journal couvre tous les événements opérationnels émis par le service.

Types d'événements du journal

Le tableau suivant récapitule les événements enregistrés par l' AWS DevOps agent.

Permissions

AWS DevOps L'agent utilise les CloudWatch journaux vendus (autorisations V2) pour fournir les journaux. Pour configurer la livraison du journal, le rôle IAM qui configure la livraison doit disposer des autorisations suivantes :

Pour connaître la politique IAM complète requise pour chaque type de destination, consultez les rubriques suivantes du guide de l'utilisateur Amazon CloudWatch Logs :

Configurer la livraison du journal (console)

AWS DevOps L'agent fournit deux emplacements dans la console AWS de gestion pour configurer la livraison des journaux :

Pour configurer la livraison des journaux pour l'enregistrement d'un service

Pour configurer la livraison des journaux pour un espace d'agent

Configuration de la livraison des journaux (CloudWatch API)

Vous pouvez également utiliser l'API CloudWatch Logs pour configurer la livraison des journaux par programmation. La livraison d'un journal de travail comprend trois éléments :

Étape 1 : créer une source de diffusion

Utilisez l'PutDeliverySourceopération pour créer une source de livraison. Transmettez l'ARN de votre ressource d'espace AWS DevOps Agent et APPLICATION_LOGS spécifiez-le comme type de journal.

L'exemple suivant crée une source de diffusion pour un espace agent :

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

L'exemple suivant crée une source de livraison pour le service :

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

Étape 2 : créer une destination de livraison

Utilisez cette PutDeliveryDestinationopération pour configurer l'emplacement de stockage des journaux. Vous pouvez choisir Amazon CloudWatch Logs, Amazon S3 ou Amazon Data Firehose.

L'exemple suivant crée une destination CloudWatch Logs :

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

L'exemple suivant crée une destination Amazon S3 :

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

L'exemple suivant crée une destination Amazon Data Firehose :

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

Si vous souhaitez utiliser CloudFormation, vous pouvez utiliser ce qui suit :

L’ResourceArn correspond à l’AgentSpaceArn et LogType doit être défini sur APPLICATION_LOGS, comme étant le type de journaux pris en charge.

Étape 3 : créer une livraison

Utilisez cette CreateDeliveryopération pour lier la source de livraison à la destination de livraison.

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

AWS CloudFormation

Vous pouvez également configurer la livraison des journaux à l' AWS CloudFormation aide des ressources suivantes :

Défini ResourceArn sur l'espace de l' AWS DevOps agent ou sur l'ARN du service de l'agent, puis défini LogType surAPPLICATION_LOGS.

Référence d’un schéma de journal

AWS DevOps L'agent utilise un schéma de journal partagé pour tous les types d'événements. Tous les événements du journal n'utilisent pas tous les champs.

Le tableau suivant décrit les champs du schéma du journal.

Gérer et désactiver la livraison des journaux

Vous pouvez modifier ou supprimer la livraison des journaux à tout moment depuis la console de l' AWS DevOps agent dans la console AWS de gestion ou à l'aide de l'API CloudWatch Logs.

Gérer la livraison des journaux (console)

Désactiver la livraison du journal (console)

Désactiver la livraison du journal (API)

Pour supprimer la livraison d'un journal à l'aide de l'API, supprimez les ressources dans l'ordre suivant :

Tarification

L' AWS DevOps agent ne facture pas l'activation des journaux vendus. Cependant, vous pouvez être facturé pour la livraison, l’ingestion, le stockage ou l’accès, selon la destination de livraison des journaux que vous avez choisie. Pour plus de détails sur les tarifs, consultez Vended Logs dans l'onglet Logs d'Amazon CloudWatch Pricing.

Pour les tarifs spécifiques à la destination, consultez les informations suivantes :