Diagnosticar e validar sua infraestrutura

Tópicos do guia:

Diagnosticar sua infraestrutura

Nesta página, você encontra orientações sobre como resolver problemas e validar sua infraestrutura do serviço de agregação. Siga as etapas para identificar e resolver problemas.

Solução de problemas do Terraform

O Terraform, a plataforma de infraestrutura como código (IaC) criada pela HashiCorp, é o principal driver para implantar o serviço de agregação na nuvem pública escolhida. Se você não tiver o Terraform instalado, consulte a documentação da HashiCorp sobre como obter a CLI localmente.

Você também pode instalar o tfenv se precisar alternar entre versões do Terraform.

Se você não encontrar uma solução para seu problema com o Serviço de agregação, notifique-nos registrando um problema no GitHub ou enviando o formulário de suporte técnico.

Se você preferir mudar o Terraform manualmente:

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 um erro do Terraform não estiver claro, ative o registro do Terraform no nível TRACE para ver a saída.

Google Cloud

O provedor do Terraform para o Google Cloud é desenvolvido em conjunto pela HashiCorp e pelo Google. Para mais dúvidas e dicas de solução de problemas, entre em contato com o suporte do Terraform do Cloud para mais informações ou acesse a seção do Google no portal Hashicorp Discuss.

Amazon Web Services

A documentação de depuração está disponível no site da AWS. Recomendamos também que você confira a seção da AWS no portal HashiCorp Discuss.

Para mais dúvidas sobre o Terraform, consulte o portal da comunidade HashiCorp (em inglês). Para orientações gerais sobre solução de problemas do Terraform, leia a documentação de depuração.

Tome muito cuidado ao modificar esses diretórios, porque a remoção deles fará com que o Terraform não reconheça mais o estado. Ele vai tentar reprovisionar todos os recursos e gerar um erro quando você tiver um recurso com o mesmo nome exato. Se o problema persistir, entre em contato com nossa equipe usando o formulário de suporte técnico.

Tome muito cuidado ao modificar esses diretórios, porque a remoção deles fará com que o Terraform não reconheça mais o estado. Ele vai tentar reprovisionar todos os recursos e gerar um erro quando você tiver um recurso com o mesmo nome exato. Se o problema persistir, entre em contato com nossa equipe usando o formulário de suporte técnico.

Validar sua configuração do Cloud

Verifique se a infraestrutura do serviço de agregação na nuvem pública escolhida foi implantada corretamente. Para isso, vamos usar relatórios de depuração de amostra e executar um job no modo de depuração. Se o Serviço de agregação conseguir receber a solicitação da API e responder, significa que ele está funcionando. Se você ainda não configurou um, recomendamos que use o Postman ou o cURL para configurar suas chamadas de API para o serviço de agregação. Os modos de depuração precisam ser desativados, definidos como "false", durante as operações normais de agregação.

Além das etapas a seguir, para validar ainda mais sua infraestrutura do Serviço de agregação, investigue todos os componentes de nuvem provisionados na sua nuvem pública.

Etapas

  1. Para gerar relatórios de depuração de amostra e arquivos de domínio de saída, siga as etapas relevantes dos codelabs:

  2. Execute uma solicitação createJob com este corpo, substituindo os marcadores destacados:

    {
  "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. Execute uma solicitação getJob para conferir a resposta. Se você receber a resposta a seguir, significa que o serviço de agregação foi implantado corretamente.

    {
    "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 você não receber uma resposta com um job_status: FINISHED, colete mais informações navegando até o recurso do Compute Engine ou do EC2 da nuvem pública escolhida. Inspecione sua instância do Serviço de agregação e os registros. Anote as informações que aparecem entre TEE container launcher initiating e TEE container launcher exiting para fornecer à nossa equipe de suporte técnico.

Google Cloud

  1. Acesse Google Cloud: Compute Engine.
  2. Clique em Instâncias de VM e selecione sua instância do serviço de agregação.
  3. Clique em Detalhes > Registros > Logging (ou pesquise "Análise de registros").

Amazon Web Services

  1. Acesse Amazon Web Services: EC2 Enclave.
  2. Clique em Instâncias do EC2 e selecione sua instância do serviço de agregação.
  3. Clique em Ações > Monitorar e resolver problemas > Acessar registro do sistema.

Inspecione e verifique se você encontra alguma correspondência com as notificações de erro no nosso guia público no GitHub.

Observação:se você acabou de fazer upgrade da versão atual do serviço de agregação, o processo completo de provisionamento pode levar até algumas horas para que a imagem da instância correta seja refletida na instância final do serviço de computação. Entre em contato se esse não for o seu caso.

Próximas etapas

Se você não encontrar uma solução para seu problema com o Serviço de agregação, notifique-nos ao registrar um problema no GitHub ou enviar o formulário de suporte técnico.