Diagnostiquer et valider votre infrastructure

Thèmes du guide:

Diagnostiquer votre infrastructure

Cette page explique comment résoudre les problèmes et valider votre infrastructure de service d'agrégation. Suivez les étapes pour identifier et résoudre les problèmes.

Résoudre les problèmes liés à Terraform

Terraform, la plate-forme Infrastructure as Code (IaC) créée par HashiCorp, est le principal moteur du déploiement du service d'agrégation dans le cloud public de votre choix. Si vous n'avez pas installé Terraform, consultez la documentation HashiCorp sur l'obtention de la CLI en local.

Vous pouvez également envisager d'installer tfenv si vos besoins vous obligent à changer de version de Terraform.

Si vous ne parvenez pas à résoudre votre problème lié au service d'agrégation, veuillez nous en informer en signalant un problème sur GitHub ou en remplissant le formulaire d'assistance technique.

Si vous préférez passer manuellement à Terraform:

rm -rf $(which terraform)
wget https://releases.hashicorp.com/terraform/1.2.3/terraform_1.2.3_linux_amd64.zip 
unzip terraform_1.2.3_linux_amd64.zip
mv terraform /usr/local/bin/terraform
terraform --version

Si une erreur Terraform n'est pas claire, vous pouvez afficher la sortie en activant la journalisation Terraform au niveau TRACE.

Google Cloud

Le fournisseur Terraform pour Google Cloud est développé conjointement par HashiCorp et Google. Pour toute question supplémentaire et pour obtenir des conseils de dépannage, contactez l'assistance Terraform de Cloud ou consultez la section Google du portail Hashicorp Discuss.

Amazon Web Services

Vous trouverez la documentation sur le débogage sur le site AWS. Nous vous invitons également à consulter la section AWS du portail de discussion HashiCorp.

Pour toute autre question concernant Terraform, consultez le portail de la communauté HashiCorp. Pour obtenir des conseils de dépannage généraux sur Terraform, consultez la documentation de débogage.

Faites très attention lorsque vous modifiez ces répertoires, car leur suppression empêchera Terraform de reconnaître l'état. Il tentera de provisionner à nouveau toutes les ressources et générera une erreur si vous disposez d'une ressource portant exactement le même nom. Si le problème persiste, contactez-nous via le formulaire d'assistance technique.

Faites très attention lorsque vous modifiez ces répertoires, car leur suppression empêchera Terraform de reconnaître l'état. Il tentera de provisionner à nouveau toutes les ressources et générera une erreur si vous disposez d'une ressource portant exactement le même nom. Si le problème persiste, contactez-nous via le formulaire d'assistance technique.

Valider votre configuration Cloud

Vérifiez si votre infrastructure de service d'agrégation dans le cloud public de votre choix a été correctement déployée. Pour ce faire, nous utiliserons des exemples de rapports de débogage et exécuterons un job en mode débogage. Si le service d'agrégation peut recevoir la requête d'API et y répondre, nous savons qu'il est opérationnel. Si vous ne l'avez pas déjà configuré, nous vous recommandons d'utiliser Postman ou cURL pour configurer vos appels d'API au service d'agrégation. Notez que les modes de débogage doivent être désactivés, définis sur "false", lors de vos opérations d'agrégation normales.

En plus des étapes suivantes, pour valider davantage votre infrastructure de service d'agrégation, examinez tous les composants cloud provisionnés dans votre cloud public.

Étapes

  1. Pour générer des exemples de rapports de débogage et de fichiers de domaine de sortie, suivez les étapes appropriées des ateliers de programmation:

  2. Exécutez une requête createJob avec ce corps, en remplaçant les espaces réservés mis en surbrillance:

    {
  "job_request_id": "<job_request_id>",
  "input_data_blob_prefix": "<report_folder>/<report_name>.avro",
  "input_data_bucket_name": "<input_bucket_name>",
  "output_data_blob_prefix": "<output_folder>/<summary_report_prefix>",
  "output_data_bucket_name": "<output_bucket_name>",
  "job_parameters": {
    "output_domain_blob_prefix": "<output_domain_folder>/<output_domain>.avro",
    "output_domain_bucket_name": "<output_domain_bucket_name>",
    "attribution_report_to": "<reporting_origin_domain>",
    "report_error_threshold_percentage": "10", // example value
    "debug_run": "true" // optional, but should be false by default
  }
}

  3. Exécutez une requête getJob pour afficher la réponse. Si vous obtenez la réponse suivante, cela signifie que votre service d'agrégation a été déployé correctement.

    {
    "job_status": "FINISHED",
    "request_received_at": <utc_timestamp>,
    "request_updated_at": <utc_timestamp>,
    "job_request_id": "<job_request_id>",
    "input_data_blob_prefix": "<report_folder>/<input_report_prefix>.avro",
    "input_data_bucket_name": "<input_bucket_name>",
    "output_data_blob_prefix": "<output_folder>/<summary_report_prefix>",
    "output_data_bucket_name": "<output_bucket_name>",
    "postback_url": "",
    "result_info": {
        "return_code": "<return_code_and_message>",
        "return_message": "Aggregation job successfully processed",
        "error_summary": {
            "error_counts": [],
            "error_messages": []
        },
        "finished_at": <utc_timestamp>
    },
    "job_parameters": {
        "debug_run": "true", // optional, but should be false by default
        "output_domain_bucket_name": "<output_domain_bucket_name>",
        "output_domain_blob_prefix": "<output_domain_folder>/<output_domain>.avro",
        "attribution_report_to": "<reporting_origin_domain>"
    },
    "request_processing_started_at": <utc_timestamp>
}

Si vous ne recevez pas de réponse avec un job_status: FINISHED, collectez plus d'informations en accédant à la ressource Compute Engine ou EC2 du cloud public de votre choix. Inspectez votre instance de service d'agrégation, inspectez les journaux et enregistrez les informations que vous voyez entre TEE container launcher initiating et TEE container launcher exiting pour les transmettre à notre équipe d'assistance technique.

Google Cloud

  1. Accédez à Google Cloud: Compute Engine.
  2. Cliquez sur Instances de VM, puis sélectionnez votre instance de service d'agrégation.
  3. Cliquez sur Détails > Journaux > Journalisation (ou recherchez "Explorateur de journaux").

Amazon Web Services

  1. Accédez à Amazon Web Services: enclave EC2.
  2. Cliquez sur Instances EC2, puis sélectionnez votre instance de service d'agrégation.
  3. Cliquez sur Actions > Surveiller et résoudre les problèmes > Obtenir le journal système.

Examinez les erreurs et vérifiez si elles correspondent aux notifications d'erreur de nos conseils publics sur GitHub.

Remarque:Si vous venez de mettre à niveau votre version actuelle de Aggregation Service, le processus de provisionnement complet peut prendre jusqu'à deux heures pour que l'image d'instance appropriée soit reflétée dans votre instance de service de calcul finale. Contactez-nous si ce n'est pas le cas.

Étapes suivantes

Si vous ne parvenez pas à résoudre votre problème lié au service d'agrégation, veuillez nous en informer en signalant un problème sur GitHub ou en remplissant le formulaire d'assistance technique.