README changes to add analytics information

Author: BoyangHuang

anthropic_usage_and_costs/README.md

@@ -2,37 +2,51 @@
 
 ## Overview
 
-Datadog's Anthropic Usage and Costs integration allows you to get visibility into your Anthropic usage and associated costs. By ingesting data from Anthropic's newly released Admin usage and cost API, this integration enables your teams to:
+Datadog's Anthropic Usage and Costs integration allows you to get visibility into your Anthropic usage and associated costs. By ingesting data from Anthropic's Admin and Analytics usage and cost APIs, this integration enables your teams to:
 
 - **Monitor LLM token consumption** (input, output, cache usage) in near real-time
 - **Track costs** by model, workspace, and service tier, supporting accurate attribution and budgeting
+- **Attribute usage and spend to individual users** (Enterprise plans) — break down token consumption and dollar cost by user, product (API, Claude Code, Claude.ai), context window, inference geography, and speed
 - **Understand usage trends** across teams, API keys, or users to optimize model usage
 - **Set up alerting and dashboards** that highlight anomalies in usage or unexpected cost spikes
 
 This integration is especially valuable for teams using Anthropic at scale who want to manage spend, understand product adoption, and ensure efficient use of AI resources-all within Datadog. With this data you will be able to introduce and validate optimization strategies to get the best out of Anthropic.
 
-You can also see your Anthropic costs in Datadog [Cloud Cost Management][6], allowing you to answer key questions: Which models or workspaces are generating the most cost? Are workloads using the right service tier (Standard, Batch, or Priority)? Are teams effectively using caching or ephemeral sessions? What's the cost breakdown between Claude Opus and Claude Sonnet?
+You can also see your Anthropic costs in Datadog [Cloud Cost Management][6], allowing you to answer key questions: Which models or workspaces are generating the most cost? Which users or teams are driving the most spend? Are workloads using the right service tier (Standard, Batch, or Priority)? Are teams effectively using caching or ephemeral sessions? What's the cost breakdown between Claude Opus and Claude Sonnet?
 
 **Minimum Agent version:** 7.69.0
 
 ## Setup
 
-To get started with the Anthropic Admin API integration in Datadog, follow the steps below:
+To get started with the Anthropic integration in Datadog, follow the steps below:
 
-### 1. Generate an Admin API Key
+### 1. Choose the right API key for your needs
 
-You will need an [Admin API key][5] from Anthropic. This key allows access to usage and cost reports across your organization.
+This integration supports two types of Anthropic API keys. Pick the one that matches the data you want to ingest:
 
-1. Navigate to your organization's settings or reach out to your Anthropic account admin to create a new Admin API key.
-2. Copy the API key to a secure location.
+| Key type | Data ingested | Best for |
+| --- | --- | --- |
+| **Admin API key** | Organization-wide usage and cost, broken down by model, workspace, API key, and service tier. | All Anthropic organizations that want org-level visibility into spend and token consumption. |
+| **Analytics API key** (Enterprise) | Per-user usage and cost, broken down by user, product (API, Claude Code, Claude.ai), model, context window, inference geography, and speed. | Enterprise organizations that need user-level attribution of usage and spend, including chargeback and team-level reporting. |
 
-### 2. Configure the Datadog Integration
+You can configure either key type — or one of each on separate accounts — depending on the level of granularity your teams require. Per-user cost data from the Analytics API is available starting **January 1, 2026**.
+
+### 2. Generate your Anthropic API key
+
+You will need either an [Admin API key][5] or an [Analytics API key][7] from Anthropic. Both are created from your Anthropic organization settings.
+
+1. Navigate to your organization's settings in the Anthropic Console, or reach out to your Anthropic account admin.
+2. Create a new **Admin API key** for org-wide reporting, or a new **Analytics API key** (with the `read:analytics` scope) for per-user reporting. Analytics keys are available on Enterprise plans and must be provisioned by your organization's **Primary Owner** at [claude.ai/analytics/api-keys][7].
+3. Copy the API key to a secure location.
+
+### 3. Configure the Datadog Integration
 
 1. In Datadog, go to [**Integrations > Anthropic Usage and Costs**](https://app.datadoghq.com/integrations?integrationId=anthropic-usage-and-costs).
-2. In the configuration panel, provide the **Admin API Key** by pasting the key you generated from Anthropic.
-3. Click **Save Configuration**.
+2. In the configuration panel, paste your **Admin API Key** or **Analytics API Key** into the API key field. Datadog automatically detects the key type and ingests the appropriate usage and cost data.
+3. (Optional) Enable **Cost data ingestion** to send cost data to [Cloud Cost Management][6]. This requires Cloud Cost Management to be enabled on your Datadog account.
+4. Click **Save Configuration**.
 
-Once saved, Datadog will begin polling Anthropic usage and cost endpoints using this key and populate metrics in your environment.
+Once saved, Datadog will begin polling the appropriate Anthropic usage and cost endpoints and populate metrics in your environment. Usage metrics typically appear within 10 minutes, and cost data appears in Cloud Cost Management within 24 hours.
 
 ## Data Collected
 
@@ -58,3 +72,4 @@ Need help? Contact [Datadog support][3].
 [4]: https://github.com/DataDog/integrations-core/blob/master/anthropic_usage_and_costs/metadata.csv
 [5]: https://docs.anthropic.com/en/api/administration-api
 [6]: /cost
+[7]: https://claude.ai/analytics/api-keys