Em alguns casos, convém usar seu próprio sistema de coleta de métricas, como o
Prometheus ou o Grafana, em paralelo ou
em vez do sistema de coleta de métricas padrão fornecido pela Apigee. Para detalhes sobre como usar seu
próprio sistema de coleta de métricas, consulte o artigo Traga seu próprio Prometheus (e o Grafana) para monitorar a Apigee híbrida
na comunidade da Apigee.
Configuração necessária
As seguintes configurações de arquivos substituem a coleta de métricas:
$GCP_REGION identifica a região
do Google Cloud em que apigee-logger
e apigee-metrics enviam os dados.
$GCP_PROJECT_ID identifica o projeto do Google Cloud em que apigee-logger e apigee-metrics enviam
dados.
$SERVICE_ACCOUNT_PATH é o caminho no sistema de arquivos para o arquivo de chave da conta de serviço do Google Cloud
de onde foi feito o download 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
Sobre contas de serviço: criar as 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-18 UTC."],[[["\u003cp\u003eApigee hybrid metrics data is sent to Cloud Operations for GKE, with metrics collection enabled by default.\u003c/p\u003e\n"],["\u003cp\u003eUsers can configure the Google Cloud region, project ID, and service account path for metrics data in the overrides file.\u003c/p\u003e\n"],["\u003cp\u003eThe service account used for metrics collection must have the Monitoring Metrics Writer role.\u003c/p\u003e\n"],["\u003cp\u003eUsers have the option to disable the default metrics collection and instead utilize their own metrics collection system, such as Prometheus or Grafana, as detailed in the linked article.\u003c/p\u003e\n"],["\u003cp\u003eDisabling metrics collection can be achieved by setting \u003ccode\u003emetrics.enabled\u003c/code\u003e 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.14 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis section describes configuration properties for sending Apigee hybrid metrics data to\n[Cloud Operations for GKE](/monitoring/kubernetes-engine).\nMetrics collection is enabled by default. See also [Metrics collection overview](./metrics-collection).\n\nIn some cases, you may wish to use your own metrics collection system, such as\nPrometheus or Grafana, in parallel with or\ninstead of the default metrics collection system provided by Apigee. For details on using your\nown metrics collection system, see the article [Bring your own Prometheus (and Grafana) to monitor Apigee hybrid](https://www.googlecloudcommunity.com/gc/Cloud-Product-Articles/BYOP-Bring-your-own-Prometheus-and-Grafana-to-monitor-Apigee/ta-p/499772)\nin the Apigee Community.\n\nRequired configuration\n----------------------\n\nThe following overrides file settings configure metrics collection: \n\n```actionscript-3\ngcp:\n region: $GCP_REGION\n projectID: $GCP_PROJECT_ID\n\nmetrics:\n serviceAccountPath: $SERVICE_ACCOUNT_PATH\n```\n\n\nWhere:\n\n- `$GCP_REGION` identifies the Google Cloud [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- `$SERVICE_ACCOUNT_PATH` is the path on your filesystem to the Google Cloud service account key file that was downloaded during the Apigee hybrid [installation procedure](/apigee/docs/hybrid/v1.14/precog-overview). The service account associated with the key must have the **Monitoring Metrics Writer** role. For details on creating service accounts, see [About service accounts: Create the service accounts](/apigee/docs/hybrid/v1.14/sa-about#create-the-service-accounts).\n\n\nExample: \n\n```actionscript-3\ngcp:\n region: us-central1\n projectID: acme-project\n\nmetrics:\n serviceAccountPath: ./service-accounts/metrics-sa.json\n```\n| **Note:** See [`metrics.serviceAccountPath`](/apigee/docs/hybrid/v1.14/config-prop-ref#metrics-serviceaccountpath) in the Configuration property reference.\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```actionscript-3\nmetrics:\n enabled: false\n```\n\n*[Google Cloud]: Google Cloud"]]
