Sending from Standalone Applications

Intro and requirements

The recommend method for sending data from Standalone Hosts is by exporting the telemetry data from applications running on the host to the BYOC endpoint as described below.

Sending from an OTLP collector? See Sending from an OpenTelemetry Collector

Send Directly from an Application

groundcover does not instrument your services with OpenTelemetry for you. The following assumes the services have already been instrumented with OpenTelemetry.

Get your InCloud Site Address

Find your inCloud site in your installation values.yaml:

global:
  ingress:
    site: {inCloud_Site}

Need help finding your site value? Contact us on Slack.

Create an Ingestion Key

See how in the ingestion key docs.

Setting Up The Required Environment Variables

Apply the environment variables below to your services in order to make them ship data to groundcover's ingestion endpoint.

It is possible to enrich specific attributes using HTTP headers - read more here. See below for an example on adding workload and env via headers.

Ingestion is supported for both OTLP/HTTP and OTLP/gRPC. Choose what your instrumentation is using - it's often part of the instrumentation itself.

OTLP/HTTP

env:
  - name: OTEL_EXPORTER_OTLP_ENDPOINT
    value: "https://{inCloud_Site}"
  - name: OTEL_EXPORTER_OTLP_PROTOCOL
    value: "http/protobuf"
  - name: OTEL_EXPORTER_OTLP_HEADERS
    value: "apikey={ingestion-key},x-groundcover-service-name=my-service,x-groundcover-env-name=my-env"

OTLP/gRPC

env:
  - name: OTEL_EXPORTER_OTLP_ENDPOINT
    value: "https://{inCloud_Site}"
  - name: OTEL_EXPORTER_OTLP_PROTOCOL
    value: "grpc"
  - name: OTEL_EXPORTER_OTLP_HEADERS
    value: "apikey={ingestion-key},x-groundcover-service-name=my-service,x-groundcover-env-name=my-env"

Troubleshooting

Common Issues

403 Forbidden / PERMISSION_DENIED

• Verify your Ingestion Key is valid and not revoked

• Ensure you're using a Third Party type Ingestion Key

• Check that the token header is correctly formatted

Connection Refused / Timeout

• Verify the inCloud endpoint URL

• Check network connectivity and firewall rules

• Ensure port 443 is accessible from your environment

Data Not Appearing

• Check application logs for OTLP exporter errors

• Verify the service name and resource attributes are set

• Allow 1-2 minutes for data to appear in groundcover UI