Skip to content

Commit d76ee74

Browse files
committed
OBSDOCS-2504: Add Google Cloud Exporter docs
1 parent d3b2426 commit d76ee74

File tree

2 files changed

+50
-0
lines changed

2 files changed

+50
-0
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
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]

observability/otel/otel-collector/otel-collector-exporters.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ include::modules/otel-exporters-aws-xray-exporter.adoc[leveloffset=+1]
3333

3434
include::modules/otel-exporters-file-exporter.adoc[leveloffset=+1]
3535

36+
include::modules/otel-exporters-google-cloud-exporter.adoc[leveloffset=+1]
37+
3638
[id="additional-resources_{context}"]
3739
[role="_additional-resources"]
3840
== Additional resources

0 commit comments

Comments
 (0)