Altyapınızı teşhis etme ve doğrulama

Rehberdeki konular:

Altyapınızı teşhis etme

Bu sayfada, Toplama Hizmeti altyapınızda sorun giderme ve doğrulama hakkında rehberlik sağlanmaktadır. Sorunları belirlemek ve çözmek için adımları uygulayın.

Terraform ile ilgili sorunları giderme

HashiCorp tarafından oluşturulan altyapıyı kod olarak (IaC) platformu Terraform, Aggregation Service'i seçtiğiniz genel buluta dağıtmanın temel itici gücüdür. Terraform yüklü değilse CLI'yı yerel olarak edinme hakkında HashiCorp dokümanlarına göz atın.

İhtiyaçlarınız Terraform sürümleri arasında geçiş yapmanızı gerektiriyorsa tfenv'yi de yükleyebilirsiniz.

Toplama hizmeti sorununuzun çözüldüğünü görmüyorsanız GitHub'da sorun bildirerek veya teknik destek formunu göndererek bize bildirin.

Terraform'u manuel olarak değiştirmeyi tercih ederseniz:

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

Bir Terraform hatası net değilse TRACE düzeyinde Terraform günlük kaydı etkinleştirilerek çıkış görüntülenebilir.

Google Cloud

Google Cloud için Terraform sağlayıcısı, HashiCorp ve Google tarafından ortaklaşa geliştirilmiştir. Diğer sorularınız ve sorun giderme önerileri için daha fazla bilgi edinmek üzere Cloud Terraform Destek Ekibi ile iletişime geçin veya Hashicorp Discuss portalının Google bölümüne gidin.

Amazon Web Services

Hata ayıklama belgelerini AWS sitesinde bulabilirsiniz. Ayrıca, HashiCorp Discuss portalının AWS bölümüne göz atmanızı öneririz.

Terraform ile ilgili diğer sorularınız için HashiCorp topluluk portalına bakın. Genel Terraform sorun giderme tavsiyeleri için hata ayıklama dokümanlarını inceleyin.

Bu dizinleri değiştirirken çok dikkatli olun. Bu dizinlerin kaldırılması, Terraform'un durumu artık tanımamasına neden olur. Tüm kaynakları yeniden sağlamaya çalışır ve tam olarak aynı ada sahip bir kaynağınız olduğunda hata verir. Bu sorun devam ederse teknik destek formu aracılığıyla bize ulaşın.

Bu dizinleri değiştirirken çok dikkatli olun. Bu dizinlerin kaldırılması, Terraform'un durumu artık tanımamasına neden olur. Tüm kaynakları yeniden sağlamaya çalışır ve tam olarak aynı ada sahip bir kaynağınız olduğunda hata verir. Bu sorun devam ederse teknik destek formu aracılığıyla bize ulaşın.

Bulut kurulumunuzu doğrulama

Seçtiğiniz genel buluttaki toplama hizmeti altyapınızın düzgün şekilde dağıtıldığını doğrulayın. Bunu yapmak için örnek hata ayıklama raporlarını kullanacak ve hata ayıklama modunda bir iş çalıştıracağız. Toplama Hizmeti, API isteğini alıp yanıtlayabiliyorsa hizmetin çalışır durumda olduğunu anlarız. Henüz ayarlamadıysanız Aggregation Service'e API çağrılarınızı ayarlamak için Postman veya cURL kullanmanızı öneririz. Normal toplama işlemleriniz sırasında hata ayıklama modlarının devre dışı bırakılması veya false olarak ayarlanması gerektiğini unutmayın.

Aşağıdaki adımlara ek olarak, toplama hizmeti altyapınızı daha fazla doğrulamak için genel bulutunuzda sağlanan tüm bulut bileşenlerini inceleyin.

Adımlar

  1. Örnek hata ayıklama raporları ve çıkış alanı dosyaları oluşturmak için ilgili codelab'lerin adımlarını uygulayın:

  2. Bu gövdeyle bir createJob isteği çalıştırın ve vurgulanan yer tutucuları değiştirin:

    {
  "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. Yanıtı görmek için getJob isteği çalıştırın. Aşağıdaki yanıtı alıyorsanız Aggregation Service'iniz düzgün şekilde dağıtılmış demektir.

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

job_status: FINISHED ile yanıt almazsanız seçtiğiniz genel bulutun Compute Engine veya EC2 kaynağına giderek daha fazla bilgi toplayın. Toplama Hizmeti örneğinizi inceleyin, günlükleri inceleyin ve TEE container launcher initiating ile TEE container launcher exiting arasında gördüğünüz bilgileri kaydedin. Bu bilgileri teknik destek ekibimize iletin.

Google Cloud

  1. Google Cloud: Compute Engine'e gidin.
  2. Sanal makine örnekleri'ni tıklayın ve toplama hizmeti örneğinizi seçin.
  3. Ayrıntılar > Günlükler > Günlük kaydı'nı tıklayın (veya Günlük Gezgini'ni arayın).

Amazon Web Services

  1. Amazon Web Services: EC2 Enclave'e gidin.
  2. EC2 örnekleri'ni tıklayın ve Toplama Hizmeti örneğinizi seçin.
  3. İşlemler > İzleme ve sorun giderme > Sistem günlüğünü al'ı tıklayın.

GitHub'daki herkese açık rehberimizde hata bildirimleriyle eşleşen bir bildirim olup olmadığını inceleyin.

Not: Aggregation Service'in mevcut sürümünü yeni yükselttiyseniz doğru örnek görüntüsünün nihai bilgi işlem hizmeti örneğinize yansıması için tam hazırlık süreci birkaç saat sürebilir. Bu durum sizin için geçerli değilse bize ulaşın.

Sonraki Adımlar

Toplama hizmeti sorununuzun çözüldüğünü görmüyorsanız GitHub'da sorun bildirerek veya teknik destek formunu göndererek bizi bilgilendirin.