---
title: "Focus Export (Experimental)"
url: "/docs/observability/focus"
canonical_url: "https://docs.litellm.ai/docs/observability/focus"
type: "docs"
last_updated: "2026-10-01"
summary: "Focus Format export is under active development and currently considered experimental."
related:
  - "/docs/observability/cloudzero"
  - "/docs/observability/greenscale_integration"
---
# Focus Export (Experimental)

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


:::warning[Experimental feature]
Focus Format export is under active development and currently considered experimental.
Interfaces, schema mappings, and configuration options may change as we iterate based on user feedback.
Please treat this integration as a preview and report any issues or suggestions to help us stabilize and improve the workflow.
:::

LiteLLM can emit usage data in the [FinOps FOCUS format](https://focus.finops.org/focus-specification/v1-2/) and push artifacts (for example Parquet files) to destinations such as Amazon S3 or Google Cloud Storage. This enables downstream cost-analysis tooling to ingest a standardised dataset directly from LiteLLM.

LiteLLM currently conforms to the FinOps FOCUS v1.2 specification when emitting this dataset.

## Overview

| Property | Details |
|----------|---------|
| Destination | Export LiteLLM usage data in FOCUS format to managed storage (S3, GCS) |
| Callback name | `focus` |
| Supported operations | Automatic scheduled export |
| Data format | FOCUS Normalised Dataset (Parquet or CSV) |

## Environment Variables

### Common settings

| Variable | Required | Description |
|----------|----------|-------------|
| `FOCUS_PROVIDER` | No | Destination provider. One of `s3`, `gcs`, `vantage`. Defaults to `s3`. |
| `FOCUS_FORMAT` | No | Output format. One of `parquet`, `csv`. Defaults to `parquet`. |
| `FOCUS_FREQUENCY` | No | Export cadence. Prefer `hourly` or `daily` for production; `interval` is intended for short test loops. Defaults to `hourly`. |
| `FOCUS_CRON_OFFSET` | No | Minute offset used for hourly/daily cron triggers. Defaults to `5`. |
| `FOCUS_INTERVAL_SECONDS` | No | Interval (seconds) when `FOCUS_FREQUENCY="interval"`. |
| `FOCUS_PREFIX` | No | Object key prefix/folder. Defaults to `focus_exports`. |

### S3 destination

| Variable | Required | Description |
|----------|----------|-------------|
| `FOCUS_S3_BUCKET_NAME` | Yes | Destination bucket for exported files. |
| `FOCUS_S3_REGION_NAME` | No | AWS region for the bucket. |
| `FOCUS_S3_ENDPOINT_URL` | No | Custom endpoint (useful for S3-compatible storage). |
| `FOCUS_S3_ACCESS_KEY` | Yes | AWS access key for uploads. |
| `FOCUS_S3_SECRET_KEY` | Yes | AWS secret key for uploads. |
| `FOCUS_S3_SESSION_TOKEN` | No | AWS session token if using temporary credentials. |

### GCS destination

| Variable | Required | Description |
|----------|----------|-------------|
| `FOCUS_GCS_BUCKET_NAME` | Yes | Destination GCS bucket for exported files. |
| `FOCUS_GCS_PATH_SERVICE_ACCOUNT` | No | Path to a service account JSON key file. Falls back to Application Default Credentials (ADC) if unset. |

## Setup via Config

### Configure environment variables

**S3**

```bash
export FOCUS_PROVIDER="s3"
export FOCUS_PREFIX="focus_exports"
export FOCUS_S3_BUCKET_NAME="my-litellm-focus-bucket"
export FOCUS_S3_REGION_NAME="us-east-1"
export FOCUS_S3_ACCESS_KEY="AKIA..."
export FOCUS_S3_SECRET_KEY="..."
```

**GCS**

```bash
export FOCUS_PROVIDER="gcs"
export FOCUS_PREFIX="focus_exports"
export FOCUS_GCS_BUCKET_NAME="my-litellm-focus-bucket"

# Optional: path to service account JSON. Omit to use Application Default Credentials.
export FOCUS_GCS_PATH_SERVICE_ACCOUNT="/path/to/service-account.json"
```

The service account (or ADC principal) needs the `storage.objects.create` permission on the destination bucket (`roles/storage.objectCreator` or broader).

### Update LiteLLM config

```yaml
model_list:
  - model_name: gpt-5.6-terra
    litellm_params:
      model: openai/gpt-5.6-terra
      api_key: sk-your-key

litellm_settings:
  callbacks: ["focus"]
```

### Start the proxy

```bash
litellm --config /path/to/config.yaml
```

During boot LiteLLM registers the Focus logger and a background job that runs according to the configured frequency.

## Planned Enhancements
- Add "Setup on UI" flow alongside the current configuration-based setup.
- Add Azure Blob to the Destination options.

## Related Links

- [Focus](https://focus.finops.org/)

## Related pages

- [CloudZero](https://docs.litellm.ai/docs/observability/cloudzero.md)
- [Greenscale](https://docs.litellm.ai/docs/observability/greenscale_integration.md)