Infrastruktur diagnostizieren und validieren

Themen des Leitfadens:

Infrastruktur diagnostizieren

Auf dieser Seite finden Sie Anleitungen zur Fehlerbehebung und Validierung Ihrer Aggregation Service-Infrastruktur. Folgen Sie der Anleitung, um Probleme zu identifizieren und zu beheben.

Fehlerbehebung bei Terraform

Terraform, die von HashiCorp entwickelte Infrastruktur-als-Code-Plattform (Infrastructure as Code, IaC), ist die Hauptkomponente für die Bereitstellung des Aggregation Service in der von Ihnen ausgewählten öffentlichen Cloud. Wenn Sie Terraform nicht installiert haben, lesen Sie die HashiCorp-Dokumentation dazu, wie Sie die Befehlszeile lokal abrufen.

Wenn Sie Terraform-Versionen wechseln müssen, sollten Sie auch die Installation von tfenv in Betracht ziehen.

Wenn Sie keine Lösung für Ihr Problem mit dem Aggregationsdienst finden, benachrichtigen Sie uns, indem Sie ein GitHub-Problem melden oder das Formular für technischen Support einreichen.

Wenn Sie Terraform lieber manuell wechseln möchten:

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

Wenn ein Terraform-Fehler nicht eindeutig ist, kann die Ausgabe durch Aktivieren des Terraform-Loggings auf der Ebene TRACE angezeigt werden.

Google Cloud

Der Terraform-Provider für Google Cloud wird gemeinsam von HashiCorp und Google entwickelt. Bei weiteren Fragen und zur Fehlerbehebung wenden Sie sich an den Cloud Terraform-Support. Weitere Informationen finden Sie auch im Google-Bereich des HashiCorp Discuss-Portals.

Amazon Web Services

Eine Dokumentation zur Fehlerbehebung finden Sie auf der AWS. Wir empfehlen Ihnen außerdem, den AWS-Bereich des HashiCorp-Diskussionsportals zu besuchen.

Weitere Fragen zu Terraform finden Sie im Community-Portal von HashiCorp. Allgemeine Tipps zur Fehlerbehebung bei Terraform finden Sie in der Dokumentation zum Debugging.

Seien Sie beim Ändern dieser Verzeichnisse sehr vorsichtig, da Terraform den Status nach dem Entfernen nicht mehr erkennt. Es wird versucht, alle Ressourcen neu bereitzustellen, und es wird ein Fehler ausgegeben, wenn Sie eine Ressource mit genau demselben Namen haben. Wenn das Problem weiterhin besteht, wenden Sie sich über dieses Formular an uns.

Seien Sie beim Ändern dieser Verzeichnisse sehr vorsichtig, da Terraform den Status nach dem Entfernen nicht mehr erkennt. Es wird versucht, alle Ressourcen neu bereitzustellen, und es wird ein Fehler ausgegeben, wenn Sie eine Ressource mit genau demselben Namen haben. Wenn das Problem weiterhin besteht, wenden Sie sich über das Formular für den technischen Support an uns.

Cloud-Einrichtung validieren

Prüfen Sie, ob die Infrastruktur des Aggregationsdienstes in der von Ihnen ausgewählten öffentlichen Cloud richtig bereitgestellt wurde. Dazu verwenden wir Beispiel-Fehlerbehebungsberichte und führen einen Job im Debug-Modus aus. Wenn der Aggregation Service die API-Anfrage empfangen und darauf antworten kann, wissen wir, dass er aktiv ist. Falls Sie noch keine eingerichtet haben, empfehlen wir Ihnen, Postman oder cURL zu verwenden, um Ihre API-Aufrufe an den Aggregation Service einzurichten. Beachten Sie, dass Debug-Modi während der normalen Aggregationsvorgänge deaktiviert bzw. auf „false“ gesetzt werden sollten.

Zusätzlich zu den folgenden Schritten sollten Sie alle Cloud-Komponenten, die in Ihrer öffentlichen Cloud bereitgestellt werden, untersuchen, um Ihre Aggregation Service-Infrastruktur weiter zu validieren.

Schritte

  1. So generieren Sie Debug-Beispielberichte und Ausgabedomänendateien:

  2. Führen Sie eine createJob-Anfrage mit diesem Text aus und ersetzen Sie die hervorgehobenen Platzhalter:

    {
  "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. Führen Sie eine getJob-Anfrage aus, um die Antwort zu sehen. Wenn Sie die folgende Antwort erhalten, wurde Ihr Aggregationsdienst ordnungsgemäß bereitgestellt.

    {
    "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>
}

Wenn Sie keine Antwort mit einem job_status: FINISHED erhalten, rufen Sie weitere Informationen ab, indem Sie zur Compute Engine- oder EC2-Ressource Ihrer ausgewählten öffentlichen Cloud wechseln. Sehen Sie sich Ihre Aggregation Service-Instanz und die Logs an und notieren Sie sich die Informationen, die zwischen TEE container launcher initiating und TEE container launcher exiting angezeigt werden, um sie unserem technischen Supportteam zur Verfügung zu stellen.

Google Cloud

  1. Rufen Sie Google Cloud: Compute Engine auf.
  2. Klicken Sie auf VM-Instanzen und wählen Sie Ihre Aggregation Service-Instanz aus.
  3. Klicken Sie auf Details > Logs > Logging (oder suchen Sie nach „Log-Explorer“).

Amazon Web Services

  1. Rufen Sie Amazon Web Services: EC2 Enclave auf.
  2. Klicken Sie auf EC2-Instanzen und wählen Sie die Instanz Ihres Aggregationsdienstes aus.
  3. Klicken Sie auf Aktionen > Monitoring und Fehlerbehebung > Systemlog abrufen.

Sehen Sie nach, ob Sie in unserer öffentlichen Anleitung auf GitHub passende Fehlermeldungen finden.

Hinweis:Wenn Sie gerade ein Upgrade Ihrer aktuellen Version des Aggregation Service durchgeführt haben, kann es bis zu zwei Stunden dauern, bis das richtige Instanz-Image in Ihrer endgültigen Compute Service-Instanz angezeigt wird. Wenden Sie sich an uns, wenn das bei Ihnen nicht der Fall ist.

Nächste Schritte

Wenn Sie keine Lösung für Ihr Problem mit dem Aggregationsdienst finden, benachrichtigen Sie uns, indem Sie ein GitHub-Problem einreichen oder das Formular für den technischen Support ausfüllen.