|
| 1 | +// Module included in the following assemblies: |
| 2 | +// |
| 3 | +// * observability/otel/otel-collector/otel-collector-exporters.adoc |
| 4 | + |
| 5 | +:_mod-docs-content-type: REFERENCE |
| 6 | +[id="otel-exporters-google-cloud-exporter_{context}"] |
| 7 | += Google Cloud Exporter |
| 8 | + |
| 9 | +[role="_abstract"] |
| 10 | +The Google Cloud Exporter can be used converts the OpenTelemetry spans, metrics and logs to the Google Cloud Trace, Monitoring, and Logging formats and then sends them directly to the Google Cloud operations suite (formerly Stackdriver). |
| 11 | + |
| 12 | +:FeatureName: The Google Cloud Exporter |
| 13 | +include::snippets/technology-preview.adoc[] |
| 14 | + |
| 15 | +The Goolge Cloud Exporter can be used to send metrics to Google Cloud Monitoring (formerly Stackdriver), traces to Google Cloud Trace, and logs to Google Cloud Logging. |
| 16 | + |
| 17 | +By default, the exporter sends telemetry to the project specified by project in the configuration. This can be overridden on a per-metrics basis using the `gcp.project.id` resource attribute. For example, if a metric has a label project, you could use the groupbyattrs processor to promote it to a resource label, and the resource processor to rename the attribute from project to `gcp.project.id`. |
| 18 | + |
| 19 | +.OpenTelemetry Collector custom resource with the enabled Google Cloud Exporter |
| 20 | +[source,yaml] |
| 21 | +---- |
| 22 | +# ... |
| 23 | + env: |
| 24 | + - name: GOOGLE_APPLICATION_CREDENTIALS |
| 25 | + value: /var/secrets/google/key.json # <1> |
| 26 | + volumeMounts: |
| 27 | + - name: google-application-credentials |
| 28 | + mountPath: /var/secrets/google |
| 29 | + readOnly: true |
| 30 | + volumes: |
| 31 | + - name: google-application-credentials |
| 32 | + secret: |
| 33 | + secretName: google-application-credentials |
| 34 | + config: |
| 35 | + exporters: |
| 36 | + googlecloud: |
| 37 | + project: # <2> |
| 38 | +# ... |
| 39 | +---- |
| 40 | +<1> The `GOOGLE_APPLICATION_CREDENTIALS` environment variable which points to the authentication `key.json` file. The `key.json` file is mounted as a secret volume to the collector. |
| 41 | +<2> Optional project identifier. If not specified, the project is determined from the credentials. |
| 42 | + |
| 43 | +[role="_additional-resources"] |
| 44 | +.Additional resources |
| 45 | +* link:https://cloud.google.com/monitoring?hl=en[Google Cloud Monitoring] |
| 46 | +* link:https://cloud.google.com/logging?hl=en[Google Cloud Logging] |
| 47 | +* link:https://cloud.google.com/trace?hl=en[Google Cloud Trace] |
| 48 | +* link:https://cloud.google.com/iam/docs/workload-identity-federation-with-kubernetes#deploy[Google Workflow Identity Federation docs] |
0 commit comments