Getting Started

Obtaining Honeycomb API Key

Click here to login to your honeycomb account. From the top left corner, select the environment you want to send data to, and click the Settings configuration gear icon to go to the settings page. Select the API Keys tab and create/copy an API Key.

Make sure the API Key is permitted to Send Events to Honeycomb.

Configuring Destination Fields

  • HONEYCOMB_API_KEY string : API Key.
    • This field is required
  • HONEYCOMB_ENDPOINT string : Endpoint. Choose one of the endpoints in the dropdown (api.honeycomb.io is the US instance, api.eu1.honeycomb.io is EU instance)
    • This field is required

Adding Destination to Odigos

There are two primary methods for configuring destinations in Odigos:

Using the UI
1

Use the Odigos CLI to access the UI

odigos ui
2

Click on Add Destination, select Honeycomb and follow the on-screen instructions

Using Kubernetes manifests
1

Save the YAML below to a file (e.g. honeycomb.yaml)

apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: honeycomb-example
  namespace: odigos-system
spec:
  data:
    HONEYCOMB_ENDPOINT: '<Endpoint (options: [api.honeycomb.io, api.eu1.honeycomb.io])>'
  destinationName: honeycomb
  secretRef:
    name: honeycomb-secret
  signals:
  - TRACES
  - METRICS
  - LOGS
  type: honeycomb

---

apiVersion: v1
data:
  HONEYCOMB_API_KEY: <Base64 API Key>
kind: Secret
metadata:
  name: honeycomb-secret
  namespace: odigos-system
type: Opaque
2

Apply the YAML using kubectl

kubectl apply -f honeycomb.yaml