Getting Started

instana Creating Account
Go to the πŸ”— Website > Account and click Log In
Obtaining Endpoint
Go to the πŸ“– Docs > Endpoints of the Instana backend otlp-acceptor and find your Endpoint
Obtaining Agent Key
Go to your πŸ“© Email > Instana Login Details and copy Agent-Key

Configuring Destination Fields

  • INSTANA_ENDPOINT string : OTLP gRPC Endpoint. Domain name of the otlp-acceptor component of the Instana backend.
    • This field is required
    • Example: otlp-{color}-saas.instana.io
  • INSTANA_AGENT_KEY string : Agent Key. The agent key of the Instana for targeting the Instana backend.
    • This field is required
For ingesting logs via OpenTelemetry, an add-on to the Instana license is required. It’s advisable to contact your IBM Sales representative to include this add-on in your account.

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 IBM Instana and follow the on-screen instructions
Using Kubernetes manifests
1

Save the YAML below to a file (e.g. instana.yaml)
apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: instana-example
  namespace: odigos-system
spec:
  data:
    INSTANA_ENDPOINT: <OTLP gRPC Endpoint>
  destinationName: instana
  secretRef:
    name: instana-secret
  signals:
  - TRACES
  - METRICS
  - LOGS
  type: instana

---

apiVersion: v1
data:
  INSTANA_AGENT_KEY: <Base64 Agent Key>
kind: Secret
metadata:
  name: instana-secret
  namespace: odigos-system
type: Opaque
2

Apply the YAML using kubectl
kubectl apply -f instana.yaml