# Open Telemetry (OTel)

### **What is OTel?**

OTel is an open-source, vendor-neutral standard for generating, collecting, and exporting telemetry data such as metrics, logs, and traces. Multitudes uses OpenTelemetry to receive your AI tooling usage data. Currently, this is only set-up for Claude Code. We will be building support for more AI tools in the future. For more on OpenTelemetry, see the [official documentation](https://opentelemetry.io/docs/what-is-opentelemetry/?utm_source=chatgpt.com).

### **What metrics we can ingest and process** 

We can ingest and process OTel data for the Claude Code [Team](https://claude.com/pricing#team-&-enterprise) and [Individual](https://claude.com/pricing) plans.

If you're on the [Claude Code API](https://claude.com/pricing#api) plan, head to our docs here: [Claude Code](https://docs.multitudes.com/integrations/claude-code). 

If you are on [Claude Code Enterprise](https://claude.com/pricing/enterprise), reach out to us at <support@multitudes.com> for access.

If you'd like to bring in Open Telemetry data from other AI tools, reach out to us at <support@multitudes.com>.

{% hint style="info" %}
If you do not see your tool or plan supported, reach out to <support@multitudes.com>
{% endhint %}

### **Requirements**

* Owner permissions in Multitudes
* Multitudes API key with OTel scope (more below)
* Multitudes OTel collector set up ([more here](https://github.com/MultitudesCo/otel-collector) - this will require your Multitudes API key).

### **To start sending AI usage data to us via OTel:**

#### Generate your Multitudes API key with OTel scope

1. From the [Settings > API Keys](https://app.multitudes.co/teamSettings/apiKeys) page, click '+ Generate New Key' on the top right corner of the page. This will pop-up a modal.

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FMGaNDt73RDDVthOvVSdy%2Fimage.png?alt=media&#x26;token=a450c8e1-54ce-42b5-ab30-d6730200039d" alt=""><figcaption></figcaption></figure>

2. In the modal, set key type to 'Organization' and select 'Write' for Open Telemetry. Once this is done, click 'Create key'

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FXClsDOqvKocjlkLEjhPy%2Fimage.png?alt=media&#x26;token=1a78e75d-1474-4105-81c8-86803ccac325" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Personal keys are for sending OTel data direct to Multitudes. This is a feature under development. Reach out to <support@multitudes.com> if this is a feature you would like to adopt.&#x20;
{% endhint %}

3. After the key has been generated, copy it for use as the Bearer token when running your Multitudes OTel collector (see further instructions below). The full key will only be shown once.&#x20;

<figure><img src="https://3759751588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1eOL1LoKX0USQQUCSepS%2Fuploads%2FRLEF1nuQgNvP4CeQFxrh%2Fimage.png?alt=media&#x26;token=788b46aa-7b63-40bc-bfd6-8c5d8448cee4" alt=""><figcaption></figcaption></figure>

Set up your Multitudes OTel Collector

Detailed instructions for how to set up your Multitudes OTel Collector and have it up and running can be found [here](https://github.com/MultitudesCo/otel-collector).&#x20;

After your collector is configured, reach out to us at <support@multitudes.com> or via Slack and we can confirm whether we are receiving your data.

Once data is being received successfully, your Claude usage metrics will appear in Multitudes after our batch processing pipeline runs. Our pipeline runs daily, so in most cases you should expect to see metrics populate in the Multitudes App within up to one day of sending data.