A coleta de métricas da Apigee híbrida fica desativada por padrão. Forneça
algumas propriedades de configuração no arquivo de modificações para permitir que
o híbrido envie os dados das métricas coletadas para o
Stackdriver.
Configuração necessária
Para permitir que a Apigee híbrida envie dados de métricas coletadas ao Stackdriver,
você precisa fornecer estas definições de configuração no arquivo de
substituições:
...
# gcpProjectID: project_ID # Deprecated.
gcp: # v1.2.0 and later: Use this element instead of gcpProjectID.
region: gcp-region
projectID: gcp-project-id
metrics:
enabled: true
serviceAccountPath: service_account_file
Em que:
gcpProjectID identifica o projeto do Google Cloud em que apigee-logger e apigee-metrics enviam
dados.
gcp-region identifica a região
do GCP para onde o apigee-logger
e o apigee-metrics enviam os dados.
gcp-project-id identifica o projeto do Google Cloud em que apigee-logger e apigee-metrics enviam
dados.
serviceAccountPath é o caminho no sistema de arquivos para o arquivo de chave
da conta de serviço do GCP que foi salvo durante o procedimento de
instalação da Apigee híbrida.
A conta de serviço associada à chave precisa ter o papel de Gravador de métricas do
Monitoring. Para detalhes sobre como criar contas de serviço, consulte a Etapa 5: adicionar
contas de serviço.
Exemplo:
...
# gcpProjectID: acme-hybrid # Deprecated
gcp: # v1.2.0 and later: Use this element instead of gcpProjectID.
region: us-central1
projectID: acme-project
metrics:
enabled: true
serviceAccountPath: ./service-accounts/metrics-sa.json
Como desativar a coleta de métricas
Para desativar a coleta de métricas, adicione a seguinte configuração às modificações e aplique-a
ao cluster:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eVersion 1.2 of the Apigee hybrid documentation is end of life, and users should upgrade to a newer version.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid metrics collection is disabled by default and requires specific configuration properties in the overrides file to enable sending data to Stackdriver.\u003c/p\u003e\n"],["\u003cp\u003eEnabling metrics requires setting \u003ccode\u003emetrics: enabled\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e and providing the correct \u003ccode\u003egcp: region\u003c/code\u003e, \u003ccode\u003egcp: projectID\u003c/code\u003e, and \u003ccode\u003eserviceAccountPath\u003c/code\u003e within the overrides file.\u003c/p\u003e\n"],["\u003cp\u003eTo disable metrics collection, you must set \u003ccode\u003emetrics: enabled\u003c/code\u003e to \u003ccode\u003efalse\u003c/code\u003e in your overrides file and apply the change to your cluster.\u003c/p\u003e\n"]]],[],null,["# Configure metrics collection\n\n| You are currently viewing version 1.2 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nApigee hybrid metrics collection is disabled by default; you must provide\na few configuration properties in your overrides file to enable hybrid\nto send the collected metrics data to\n[Stackdriver](https://cloud.google.com/monitoring/kubernetes-engine/).\n\nRequired configuration\n----------------------\n\n\nTo enable Apigee hybrid to send collected metrics data to [Stackdriver](https://cloud.google.com/monitoring/kubernetes-engine/),\nyou must provide these configuration settings in your overrides\nfile: \n\n ...\n\n # gcpProjectID: project_ID # Deprecated.\n\n gcp: # v1.2.0 and later: Use this element instead of gcpProjectID.\n region: gcp-region\n projectID: gcp-project-id\n\n metrics:\n enabled: true\n serviceAccountPath: service_account_file\n\n\nWhere:\n\n- `gcpProjectID` identifies the project where `apigee-logger` and the `apigee-metrics` push their data.\n- `gcp-region` identifies the GCP [region](https://cloud.google.com/compute/docs/regions-zones#available) where the `apigee-logger` and the `apigee-metrics` push their data.\n- `gcp-project-id` identifies the project where `apigee-logger` and the `apigee-metrics` push their data.\n- `serviceAccountPath` is the path on your filesystem to the GCP service account key file that was downloaded during the Apigee hybrid [installation procedure](/apigee/docs/hybrid/v1.2/precog-overview). The service account associated with the key must have the **Monitoring Metrics Writer** role. For details on creating service accounts, see [Step 5: Add service\n accounts](/apigee/docs/hybrid/v1.2/precog-serviceaccounts).\n\n\nExample: \n\n ...\n\n # gcpProjectID: acme-hybrid # Deprecated\n\n gcp: # v1.2.0 and later: Use this element instead of gcpProjectID.\n region: us-central1\n projectID: acme-project\n\n metrics:\n enabled: true\n serviceAccountPath: ./service-accounts/metrics-sa.json\n\nHow to disable metrics collection\n---------------------------------\n\nTo disable metrics collection, add the following configuration to your overrides and apply it\nto the cluster:\n\n```text\n...\nmetrics:\n enabled: false\n...\n```\n\n*[Google Cloud]: Google Cloud"]]
