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 é um código do projeto do GCP; Os dados de métricas serão enviados para a instância do Stackdriver
nesse projeto.
k8sClusterName é o nome do cluster do Kubernetes em que o ambiente de execução híbrido
está instalado.
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.
[[["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\u003eThe current Apigee hybrid documentation version (1.1) is end-of-life and an upgrade to a newer version is required.\u003c/p\u003e\n"],["\u003cp\u003eApigee hybrid metrics collection is disabled by default and must be explicitly enabled through configuration.\u003c/p\u003e\n"],["\u003cp\u003eEnabling metrics collection requires specifying the GCP project ID, Kubernetes cluster name, and the path to a service account key file with the Monitoring Metrics Writer role in the overrides file.\u003c/p\u003e\n"],["\u003cp\u003eMetrics collection can be disabled by setting the \u003ccode\u003emetrics.enabled\u003c/code\u003e property to \u003ccode\u003efalse\u003c/code\u003e in the overrides file.\u003c/p\u003e\n"]]],[],null,["# Configure metrics collection\n\n| You are currently viewing version 1.1 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...\ngcpProjectID: project_ID\nk8sClusterName: cluster_name\n...\nmetrics:\n enabled: true\n serviceAccountPath: service_account_file\n```\n\n\nWhere:\n\n- `gcpProjectID` is a GCP project ID. Metrics data will be sent to the Stackdriver instance in that project.\n- `k8sClusterName` is the name of the Kubernetes cluster where the hybrid runtime is installed.\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.1/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.1/precog-serviceaccounts).\n\n\nExample: \n\n```\n...\ngcpProjectID: acme-hybrid\nk8sClusterName: acme-hybrid\n...\nmetrics:\n enabled: true\n serviceAccountPath: ./service-accounts/metrics-sa.json\n```\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```"]]
