Diagnosticar e validar sua infraestrutura

Temas do guia:

Diagnosticar sua infraestrutura

Esta página fornece 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 impulsionador 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 instalar a CLI localmente.

Você também pode instalar o tfenv, se as necessidades exigirem que você altere as versões do Terraform.

Se você não encontrar uma solução para o problema do serviço de agregação, notifique a gente registrando um problema do 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, a saída poderá ser visualizada ativando a geração de registros do Terraform no nível TRACE.

Google Cloud

O provedor do Terraform para o Google Cloud é desenvolvido em conjunto pela HashiCorp e pelo Google. Para mais perguntas e conselhos 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 de discussão do Hashicorp.

Amazon Web Services

A documentação de depuração pode ser encontrada no site da AWS. Também recomendamos que você confira a seção "AWS" do portal da HashiCorp Discuss.

Para mais dúvidas sobre o Terraform, consulte o portal da comunidade da HashiCorp. Para orientações gerais de 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 faz com que o Terraform não reconheça mais o estado. Ele vai tentar provisionar todos os recursos novamente e gerar um erro quando você tiver um recurso com o mesmo nome. Se o problema persistir, entre em contato com nossa equipe pelo formulário de suporte técnico.

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

Validar a configuração do Cloud

Verifique se a infraestrutura de serviço de agregação na nuvem pública escolhida foi implantada corretamente. Para isso, vamos usar exemplos de relatórios de depuração 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, saberemos que ele está funcionando. Se você ainda não tiver configurado uma, 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 falsos, durante as operações de agregação normais.

Além das etapas a seguir, para validar ainda mais a infraestrutura do serviço de agregação, investigue todos os componentes de nuvem provisionados na 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, acesso o Compute Engine ou o recurso EC2 da nuvem pública escolhida para coletar mais informações. Inspecione a instância do serviço de agregação e os registros e registre 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 a 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 a instância do serviço de agregação.
  3. Clique em Ações > Monitorar e resolver problemas > Acessar registro do sistema.

Inspecione e veja se você encontra alguma correspondência com as notificações de erro no nosso orientação pública no GitHub.

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

Próximas etapas

Se você não encontrar uma solução para o problema do serviço de agregação, notifique-nos enviando um problema do GitHub ou preenchendo o formulário de suporte técnico.