Surveillance des journaux du pipeline

Vous pouvez activer la journalisation pour les pipelines d'OpenSearchingestion Amazon afin d'afficher les messages d'erreur et d'avertissement émis lors des opérations du pipeline et de l'activité d'ingestion. OpenSearchIngestion publie tous les journaux sur Amazon CloudWatch Logs. CloudWatchLes journaux peuvent surveiller les informations contenues dans les fichiers journaux et vous avertir lorsque certains seuils sont atteints. Vous pouvez également archiver vos données de journaux dans une solution de stockage hautement durable. Pour de plus amples informations, veuillez consulter le Guide de l'utilisateur Amazon CloudWatch Logs.

Les journaux d'OpenSearchingestion peuvent indiquer un échec du traitement des demandes, des erreurs d'authentification entre la source et le récepteur et d'autres avertissements pouvant être utiles pour la résolution des problèmes. Pour ses journaux, OpenSearch Ingestion utilise les niveaux de journalisation de INFOWARN,ERROR, etFATAL. Nous vous recommandons d'activer la publication des journaux pour tous les pipelines.

Autorisations nécessaires

Pour permettre à OpenSearch Ingestion d'envoyer les CloudWatch journaux vers Logs, vous devez être connecté en tant qu'utilisateur disposant de certaines autorisations IAM.

Pour créer et mettre à jour les ressources de diffusion des CloudWatch journaux, vous devez disposer des autorisations suivantes :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Resource": "*",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:PutResourcePolicy",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:DescribeResourcePolicies",
                "logs:GetLogDelivery",
                "logs:ListLogDeliveries"
            ]
        }
    ]
}

Activer la publication des journaux

Vous pouvez activer la publication des journaux sur des pipelines existants ou lors de la création d'un pipeline. Pour savoir comment activer la publication des journaux lors de la création du pipeline, consultezCréation de pipelines.

Console

Pour activer la publication des journaux sur un pipeline existant

1. Connectez-vous à la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/home.

2. Choisissez Ingestion dans le panneau de navigation de gauche et sélectionnez le pipeline pour lequel vous souhaitez activer les journaux.

3. Choisissez Modifier les options de publication du journal.

4. Sélectionnez Publier dans les CloudWatch journaux.

5. Créez un groupe de journaux ou sélectionnez un groupe existant. Nous vous recommandons de formater le nom sous la forme d'un chemin, tel que/aws/vendedlogs/OpenSearchIngestion/pipeline-name/audit-logs. Ce format facilite l'application d'une politique d'CloudWatchaccès qui accorde des autorisations à tous les groupes de journaux sous un chemin spécifique, tel que/aws/vendedlogs/OpenSearchService/OpenSearchIngestion.

   Important

   Vous devez inclure le préfixe vendedlogs dans le nom du groupe de journaux, sinon la création échoue.

6. Choisissez Save (Enregistrer).

INTERFACE DE LIGNE DE COMMANDE (CLI)

Pour activer la publication des journaux à l'aide duAWS CLI, envoyez la requête suivante :

aws osis update-pipeline \
  --pipeline-name my-pipeline \
  --log-publishing-options  IsLoggingEnabled=true,CloudWatchLogDestination={LogGroup="/aws/vendedlogs/OpenSearchIngestion/pipeline-name"}