> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unomiq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> How to get started with Unomiq

## Sending and monitoring OpenTelemetry traces

<Steps>
  <Step title="Create an Application and API Key">
    Create an application using the [Unomiq Dashboard](https://dashboard.unomiq.com).

    Then, create API credentials with the `write:traces` permission for the application. This will give you an API key (**Client ID**) and secret (**Client Secret**) needed to authenticate with the gateway.
  </Step>

  <Step title="Send OpenTelemetry Traces">
    Export your OpenTelemetry traces to the Unomiq Gateway API. You can use an OTel Collector sidecar or send traces directly from your application.

    Follow the [Sending Traces](/guides/sending-traces-to-otel-gateway) guide for detailed setup instructions.
  </Step>

  <Step title="Attach a Unit to Span Attributes">
    Add the `unomiq.unit` span attribute to link traces to logical entities in your application, such as customer IDs, tenant IDs, or user IDs. This enables per-unit filtering and cost analysis.

    Follow the [Attaching a Unit to Traces](/guides/attaching-unit-to-traces) guide to set this up.
  </Step>
</Steps>

## Configure Billing Import

Enable detailed billing export from your cloud provider so Unomiq can ingest cost data and provide per-unit cost attribution.

Follow the [Enabling GCP Detailed Billing Export](/guides/enabling-gcp-detailed-billing-export) guide to set up the export to BigQuery.

## Using the Query Engine

Once traces and billing data are flowing, use the [Get Traces](/api-reference/engine/get-traces) endpoint to query traces and spans with filters such as unit, service name, and time range.
