Diagnostica e convalida l'infrastruttura

Argomenti della guida:

Esegui la diagnostica dell'infrastruttura

Questa pagina fornisce indicazioni su come risolvere i problemi e convalidare l'infrastruttura del servizio di aggregazione. Segui i passaggi per identificare e risolvere i problemi.

Risoluzione dei problemi di Terraform

Terraform, la piattaforma Infrastructure as Code (IaC) creata da HashiCorp, è il principale motore per il deployment del servizio di aggregazione nel cloud pubblico che preferisci. Se non hai installato Terraform, consulta la documentazione di HashiCorp su come ottenere l'interfaccia a riga di comando localmente.

Puoi anche prendere in considerazione l'installazione di tfenv, se le tue esigenze richiedono di cambiare versione di Terraform.

Se non vedi una soluzione al tuo problema con il servizio di aggregazione, comunicacelo segnalando un problema su GitHub o inviando il modulo di assistenza tecnica.

Se preferisci passare manualmente a 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

Se un errore di Terraform non è chiaro, l'output può essere visualizzato attivando la registrazione di Terraform a livello TRACE.

Google Cloud

Il provider Terraform per Google Cloud è sviluppato congiuntamente da HashiCorp e Google. Per ulteriori domande e consigli per la risoluzione dei problemi, contatta l'assistenza Terraform di Google Cloud per maggiori informazioni o visita la sezione Google del portale Hashicorp Discuss.

Amazon Web Services

La documentazione sul debug è disponibile sul sito AWS. Ti invitiamo inoltre a consultare la sezione AWS del portale HashiCorp Discuss.

Per ulteriori domande su Terraform, consulta il portale della community di HashiCorp. Per consigli sulla risoluzione dei problemi generali di Terraform, consulta la documentazione sul debug.

Presta molta attenzione quando modifichi queste directory, perché la loro rimozione impedirà a Terraform di riconoscere lo stato. Tenterà di eseguire di nuovo il provisioning di tutte le risorse e genererà un errore quando avrai una risorsa con lo stesso nome esatto. Se il problema persiste, contattaci tramite il modulo di assistenza tecnica.

Presta molta attenzione quando modifichi queste directory, perché la loro rimozione impedirà a Terraform di riconoscere lo stato. Tenterà di eseguire di nuovo il provisioning di tutte le risorse e genererà un errore quando avrai una risorsa con lo stesso nome esatto. Se il problema persiste, contattaci tramite il modulo di assistenza tecnica.

Convalidare la configurazione del cloud

Verifica che l'infrastruttura del servizio di aggregazione nel cloud pubblico scelto sia stata implementata correttamente. Per farlo, utilizzeremo report di debug di esempio ed eseguiremo un job in modalità di debug. Se il servizio di aggregazione è in grado di ricevere la richiesta API e rispondere, sappiamo che è attivo e funzionante. Se non ne hai ancora configurato uno, ti consigliamo di utilizzare Postman o cURL per configurare le chiamate API al servizio di aggregazione. Tieni presente che le modalità di debug devono essere disattivate, impostate su false, durante le normali operazioni di aggregazione.

Oltre ai passaggi seguenti, per convalidare ulteriormente l'infrastruttura del servizio di aggregazione, esamina tutti i componenti cloud di cui viene eseguito il provisioning nel tuo cloud pubblico.

Passaggi

  1. Per generare report di debug di esempio e file di dominio di output, segui i passaggi pertinenti dei codelab:

  2. Esegui una richiesta createJob con questo corpo, sostituendo i segnaposto evidenziati:

    {
  "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. Esegui una richiesta getJob per visualizzare la risposta. Se ricevi la seguente risposta, significa che il servizio di aggregazione è stato implementato correttamente.

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

Se non ricevi una risposta con un job_status: FINISHED, raccogli ulteriori informazioni accedendo alla risorsa Compute Engine o EC2 del cloud pubblico che hai scelto. Ispeziona l'istanza del servizio di aggregazione e i log e registra le informazioni visualizzate tra TEE container launcher initiating e TEE container launcher exiting da fornire al nostro team di assistenza tecnica.

Google Cloud

  1. Vai a Google Cloud: Compute Engine.
  2. Fai clic su Istanze VM e seleziona l'istanza del servizio di aggregazione.
  3. Fai clic su Dettagli > Log > Logging (o cerca Esplora log).

Amazon Web Services

  1. Vai ad Amazon Web Services: EC2 Enclave.
  2. Fai clic su Istanze EC2 e seleziona l'istanza del servizio di aggregazione.
  3. Fai clic su Azioni > Monitora e risolvi i problemi > Ottieni log di sistema.

Controlla se trovi corrispondenze con le notifiche di errore nella nostra guida pubblica su GitHub.

Nota:se hai appena eseguito l'upgrade della versione attuale del servizio di aggregazione, l'intero processo di provisioning potrebbe richiedere fino a un paio d'ore prima che l'immagine dell'istanza corretta venga visualizzata nell'istanza finale del servizio di calcolo. Contattaci se non è il tuo caso.

Passaggi successivi

Se non vedi una soluzione al problema del servizio di aggregazione, comunicacelo segnalando un problema su GitHub o inviando il modulo di assistenza tecnica.