Diagnostiquer et valider votre infrastructure

Thèmes du guide :

Diagnostiquer votre infrastructure

Cette page explique comment résoudre les problèmes liés à votre infrastructure de service d'agrégation et la valider. Suivez la procédure pour identifier et résoudre les problèmes.

Dépannage de 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 sur 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 vous avez besoin de changer de version de Terraform.

Si vous ne trouvez pas de solution à votre problème lié au service d'agrégation, prévenez-nous en signalant un problème GitHub ou en envoyant le formulaire d'assistance technique.

Si vous préférez changer manuellement de 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 le résultat 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 ou tout conseil de dépannage, contactez l'assistance Terraform pour Google Cloud pour en savoir plus ou rendez-vous dans la section Google du portail Hashicorp Discuss.

Amazon Web Services

La documentation sur le débogage est disponible 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.

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

Soyez très prudent lorsque vous modifiez ces répertoires, car leur suppression empêchera Terraform de reconnaître l'état. Il tentera de réapprovisionner toutes les ressources et générera une erreur si vous avez 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 l'infrastructure de votre service d'agrégation dans le cloud public de votre choix a été déployée correctement. 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 est en mesure de recevoir la requête API et d'y répondre, nous savons qu'il est opérationnel. Si vous n'en avez pas encore 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 des fichiers de domaine de sortie, suivez les étapes correspondantes des ateliers de programmation :

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

    {
  "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 Aggregation Service, ainsi que les journaux, et notez les informations qui s'affichent entre TEE container launcher initiating et TEE container launcher exiting pour les fournir à 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 Aggregation Service.
  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 Aggregation Service.
  3. Cliquez sur Actions > Surveiller et résoudre les problèmes > Obtenir le journal système.

Examinez les notifications d'erreur et voyez si vous en trouvez qui correspondent dans nos conseils publics sur GitHub.

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

Étapes suivantes

Si vous ne trouvez pas de solution à votre problème lié au service d'agrégation, informez-nous en créant un problème GitHub ou en remplissant le formulaire d'assistance technique.