Claude AI metrics

Loading version...

Port's Claude integration allows you to ingest Claude AI (Enterprise) and Claude Platform usage, cost, and Claude Code analytics metrics into your software catalog.

Supported resources claude-ai-user-activityclaude-ai-user-usageclaude-ai-user-costclaude-platform-usage-recordclaude-platform-cost-recordclaude-platform-code-analytics

Deployment modes

The integration runs in one of two deployment modes, controlled by the isClaudeEnterprise configuration option. Each mode targets a different set of Claude API endpoints and requires an API key with a different scope.

Mode	isClaudeEnterprise	Resources synced	Required API key scope
Claude AI (Enterprise)	true (default)	claude-ai-user-activity, claude-ai-user-usage, claude-ai-user-cost	read:analytics
Claude Platform	false	claude-platform-usage-record, claude-platform-cost-record, claude-platform-code-analytics	api:admin

Use Claude AI (Enterprise) mode to track per-user engagement, token usage, and cost for everyday Claude usage such as the web app and Claude Code. Use Claude Platform mode to track aggregated usage and cost for Claude Platform API consumption, typically used by developers.

Blueprints for both modes

When initializePortResources is enabled, the integration creates the default blueprints for both Claude AI and Claude Platform, regardless of the selected mode. Only the resources for the active mode are populated with data.

Prerequisites

• An Anthropic API key for the deployment mode you want to use:
  • Claude AI (Enterprise) mode requires an analytics API key with the read:analytics scope, minted by a Primary Owner from claude.ai/analytics/api-keys.
  • Claude Platform mode requires an Admin API key with the api:admin scope and access to the usage and cost reports.
• Your Port user role is set to Admin.

Setup

Choose one of the installation methods below. If you are not sure which option to use, review the installation methods overview.

Configuration

Port integrations use a YAML mapping block to ingest data from the third-party API into Port.

The mapping uses the JQ JSON processor to transform fields and shape incoming Claude data into Port entities.

Default mapping configuration

This is the default mapping configuration for this integration. It maps the Claude AI (Enterprise) resources, which are synced in the default deployment mode:

Default mapping configuration (Click to expand)

resources:
  - kind: claude-ai-user-activity
    selector:
      query: 'true'
      timeFrame: 30
    port:
      entity:
        mappings:
          identifier: .user.id + "-" + .__date
          title: (.user.email_address // .user.id) + " - " + .__date
          blueprint: '"claude_ai_user_activity"'
          properties:
            record_date: .__date + "T00:00:00Z"
            user_id: .user.id
            email: .user.email_address
            chat_conversation_count: (.chat_metrics.distinct_conversation_count // 0)
            chat_message_count: (.chat_metrics.message_count // 0)
            chat_thinking_message_count: (.chat_metrics.thinking_message_count // 0)
            chat_skills_used_count: (.chat_metrics.distinct_skills_used_count // 0)
            chat_connectors_used_count: (.chat_metrics.connectors_used_count // 0)
            code_session_count: (.claude_code_metrics.core_metrics.distinct_session_count // 0)
            code_commit_count: (.claude_code_metrics.core_metrics.commit_count // 0)
            code_pull_request_count: (.claude_code_metrics.core_metrics.pull_request_count // 0)
            lines_added: (.claude_code_metrics.core_metrics.lines_of_code.added_count // 0)
            lines_removed: (.claude_code_metrics.core_metrics.lines_of_code.removed_count // 0)
            edit_tool_accepted: (.claude_code_metrics.tool_actions.edit_tool.accepted_count // 0)
            edit_tool_rejected: (.claude_code_metrics.tool_actions.edit_tool.rejected_count // 0)
            write_tool_accepted: (.claude_code_metrics.tool_actions.write_tool.accepted_count // 0)
            write_tool_rejected: (.claude_code_metrics.tool_actions.write_tool.rejected_count // 0)
            multi_edit_tool_accepted: (.claude_code_metrics.tool_actions.multi_edit_tool.accepted_count // 0)
            multi_edit_tool_rejected: (.claude_code_metrics.tool_actions.multi_edit_tool.rejected_count // 0)
            notebook_edit_tool_accepted: (.claude_code_metrics.tool_actions.notebook_edit_tool.accepted_count // 0)
            notebook_edit_tool_rejected: (.claude_code_metrics.tool_actions.notebook_edit_tool.rejected_count // 0)
            web_search_count: (.web_search_count // 0)
            chat_projects_used_count: (.chat_metrics.distinct_projects_used_count // 0)
            chat_projects_created_count: (.chat_metrics.distinct_projects_created_count // 0)
            chat_artifacts_created_count: (.chat_metrics.distinct_artifacts_created_count // 0)
            chat_files_uploaded_count: (.chat_metrics.distinct_files_uploaded_count // 0)
            chat_shared_conversations_viewed_count: (.chat_metrics.shared_conversations_viewed_count // 0)
            office_session_count: >-
              ([.office_metrics.excel.distinct_session_count,
              .office_metrics.powerpoint.distinct_session_count,
              .office_metrics.word.distinct_session_count,
              .office_metrics.outlook.distinct_session_count] | map(. // 0) | add)
            office_message_count: >-
              ([.office_metrics.excel.message_count,
              .office_metrics.powerpoint.message_count,
              .office_metrics.word.message_count,
              .office_metrics.outlook.message_count] | map(. // 0) | add)
            cowork_session_count: (.cowork_metrics.distinct_session_count // 0)
            cowork_message_count: (.cowork_metrics.message_count // 0)
            design_session_count: (.design_metrics.distinct_session_count // 0)
            design_message_count: (.design_metrics.message_count // 0)
  - kind: claude-ai-user-usage
    selector:
      query: 'true'
      startingAt: '2026-01-01T00:00:00Z'
    port:
      entity:
        mappings:
          identifier: >-
            .actor.user_id + "-" + .__starting_at[:10] + "-" + (.product // "all")
            + "-" + (.model // "all")
          title: (.actor.name // .actor.email // .actor.user_id) + " - " + .__starting_at[:10]
          blueprint: '"claude_ai_user_usage"'
          properties:
            record_date: .__starting_at
            range_end: .__ending_at
            user_id: .actor.user_id
            user_name: .actor.name
            email: .actor.email
            deleted: (.actor.deleted // false)
            product: .product
            model: .model
            context_window: .context_window
            inference_geo: .inference_geo
            speed: .speed
            uncached_input_tokens: (.uncached_input_tokens // 0)
            cache_creation_1h_tokens: (.cache_creation.ephemeral_1h_input_tokens // 0)
            cache_creation_5m_tokens: (.cache_creation.ephemeral_5m_input_tokens // 0)
            cache_read_input_tokens: (.cache_read_input_tokens // 0)
            output_tokens: (.output_tokens // 0)
            total_tokens: (.total_tokens // 0)
            web_search_requests: (.server_tool_use.web_search_requests // 0)
            requests: (.requests // 0)
  - kind: claude-ai-user-cost
    selector:
      query: 'true'
      startingAt: '2026-01-01T00:00:00Z'
    port:
      entity:
        mappings:
          identifier: >-
            .actor.user_id + "-" + .__starting_at[:10] + "-" + (.product // "all")
            + "-" + (.model // "all")
          title: (.actor.name // .actor.email // .actor.user_id) + " - " + .__starting_at[:10]
          blueprint: '"claude_ai_user_cost"'
          properties:
            record_date: .__starting_at
            range_end: .__ending_at
            user_id: .actor.user_id
            user_name: .actor.name
            email: .actor.email
            deleted: (.actor.deleted // false)
            product: .product
            model: .model
            currency: (.currency // "USD")
            amount: ((.amount // "0") | tonumber) / 100
            list_amount: ((.list_amount // "0") | tonumber) / 100
            requests: (.requests // 0)

Advanced selector configuration

The available selectors depend on the active deployment mode. query applies to all resource kinds in both modes and defaults to 'true'.

Claude AI (Enterprise)

claude-ai-user-activity

This resource returns data for one specific day per call. The endpoint only returns data that is at least three days old, so the date window always ends roughly three days ago. To control the start of the window, provide one of timeFrame or startingDate (mutually exclusive). When you set neither, the integration defaults to a 30-day lookback.

Field	Format	Description
timeFrame	number	Number of days to look back, ending around three days ago. Must be greater than 0. Mutually exclusive with startingDate. Defaults to 30 when neither field is set.
startingDate	YYYY-MM-DD	Iterates from this date once per day up to around three days ago, clamped to 2026-01-01 (the earliest available data). Use for historical backfills. Mutually exclusive with timeFrame.

Using timeFrame (recommended for ongoing syncs):

selector:
  query: 'true'
  timeFrame: 30 # look back 30 days, one API call per day

Using startingDate (for a historical backfill):

selector:
  query: 'true'
  startingDate: '2026-01-01' # iterate from this date, one API call per day

claude-ai-user-usage and claude-ai-user-cost

These resources return per-user data across a date range and share the same selector fields.

Field	Type	Description
startingAt	string	RFC 3339 UTC start of the range (inclusive), e.g. 2026-01-01T00:00:00Z. Automatically clamped to the last 31 days and no earlier than 2026-01-01. Defaults to 2026-01-01T00:00:00Z.
endingAt	string	RFC 3339 UTC end of the range (exclusive). Defaults to now. The range spans at most 31 days.
excludeDeletedUsers	boolean	When true, rows for deleted users are omitted. Defaults to false.
products	array	Filter to specific seat-based product surfaces. Allowed values: chat, claude_code, cowork, office_agent, claude_in_chrome, claude_design.
models	array	Filter to specific model names.
groupBy	array	Break each user's row out by the given dimensions. Allowed values: product, model, context_window, inference_geo, speed.
contextWindows	array	Filter to specific context-window pricing tiers. Allowed values: 0-200k, 200k-1M.
inferenceGeos	array	Filter to specific inference regions. Allowed values: global, us, not_available.
speeds	array	Filter to fast or standard inference mode. Allowed values: fast, standard.

selector:
  query: 'true'
  startingAt: '2026-01-01T00:00:00Z'
  endingAt: '2026-01-31T00:00:00Z'
  excludeDeletedUsers: false
  products: [chat, claude_code]
  groupBy: [product, model]

Claude Platform

The Claude Platform selectors behave as follows:

• startingDate is required for claude-platform-usage-record and claude-platform-cost-record. For claude-platform-code-analytics, either startingDate or timeFrame must be provided (mutually exclusive).
• bucketWidth controls time granularity for usage and cost resources.
• groupBy is available for claude-platform-usage-record and lets you break down usage by dimensions.

claude-platform-usage-record

selector:
  query: 'true'
  startingDate: '2026-01-01T00:00:00Z'
  bucketWidth: 1d # supported: 1m | 1h | 1d
  groupBy: [workspace_id]

• startingDate must use ISO-8601 UTC format (YYYY-MM-DDTHH:MM:SSZ).
• bucketWidth supports 1m, 1h, and 1d for usage records.
• groupBy supports dimensions such as api_key_id, workspace_id, context_window, speed, inference_geo, account_id, service_account_id, model, and service_tier.

claude-platform-cost-record

selector:
  query: 'true'
  startingDate: '2026-01-01T00:00:00Z'
  bucketWidth: 1d

• startingDate must use ISO-8601 UTC format (YYYY-MM-DDTHH:MM:SSZ).
• bucketWidth supports 1d only for cost records in this integration.

claude-platform-code-analytics

The API returns data for one specific day per call. To control the date window, provide exactly one of the following fields:

Field	Format	Description
timeFrame	number	Number of days to look back from today. The integration calls the API once per day for each of the last N days. Recommended for ongoing syncs.
startingDate	YYYY-MM-DD	Iterates from this date to today, calling the API once per day. Use for historical backfills. A warning is logged and no data is fetched if the date is in the future.

Mutually exclusive

timeFrame and startingDate cannot both be set on claude-platform-code-analytics. Providing neither or both will cause a validation error.

Using timeFrame (recommended for ongoing syncs):

selector:
  query: 'true'
  timeFrame: 30 # fetch the last 30 days, one API call per day

Using startingDate (for a historical backfill):

selector:
  query: 'true'
  startingDate: '2026-01-01' # iterate from this date to today

Mapping & examples per resource

To view and test the integration mapping against sample API responses, use the jq playground in your data sources page.

Claude AI (Enterprise)

{
  "identifier": "claude_ai_user_activity",
  "description": "Per-user Claude (chat) and Claude Code engagement metrics for a single day",
  "title": "Claude AI User Activity",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "user_id": {
        "type": "string",
        "title": "User ID"
      },
      "email": {
        "type": "string",
        "format": "user",
        "title": "Email"
      },
      "chat_conversation_count": {
        "type": "number",
        "title": "Chat Conversations"
      },
      "chat_message_count": {
        "type": "number",
        "title": "Chat Messages"
      },
      "chat_thinking_message_count": {
        "type": "number",
        "title": "Chat Thinking Messages"
      },
      "chat_skills_used_count": {
        "type": "number",
        "title": "Chat Skills Used"
      },
      "chat_connectors_used_count": {
        "type": "number",
        "title": "Chat Connectors Used"
      },
      "code_session_count": {
        "type": "number",
        "title": "Claude Code Sessions"
      },
      "code_commit_count": {
        "type": "number",
        "title": "Claude Code Commits"
      },
      "code_pull_request_count": {
        "type": "number",
        "title": "Claude Code Pull Requests"
      },
      "lines_added": {
        "type": "number",
        "title": "Lines Added"
      },
      "lines_removed": {
        "type": "number",
        "title": "Lines Removed"
      },
      "edit_tool_accepted": {
        "type": "number",
        "title": "Edit Tool Accepted"
      },
      "edit_tool_rejected": {
        "type": "number",
        "title": "Edit Tool Rejected"
      },
      "write_tool_accepted": {
        "type": "number",
        "title": "Write Tool Accepted"
      },
      "write_tool_rejected": {
        "type": "number",
        "title": "Write Tool Rejected"
      },
      "web_search_count": {
        "type": "number",
        "title": "Web Search Count"
      },
      "chat_projects_used_count": {
        "type": "number",
        "title": "Chat Projects Used"
      },
      "chat_projects_created_count": {
        "type": "number",
        "title": "Chat Projects Created"
      },
      "chat_artifacts_created_count": {
        "type": "number",
        "title": "Chat Artifacts Created"
      },
      "chat_files_uploaded_count": {
        "type": "number",
        "title": "Chat Files Uploaded"
      },
      "chat_shared_conversations_viewed_count": {
        "type": "number",
        "title": "Chat Shared Conversations Viewed"
      },
      "multi_edit_tool_accepted": {
        "type": "number",
        "title": "Multi-Edit Tool Accepted"
      },
      "multi_edit_tool_rejected": {
        "type": "number",
        "title": "Multi-Edit Tool Rejected"
      },
      "notebook_edit_tool_accepted": {
        "type": "number",
        "title": "Notebook Edit Tool Accepted"
      },
      "notebook_edit_tool_rejected": {
        "type": "number",
        "title": "Notebook Edit Tool Rejected"
      },
      "office_session_count": {
        "type": "number",
        "title": "Office Sessions (Excel/PPT/Word/Outlook)"
      },
      "office_message_count": {
        "type": "number",
        "title": "Office Messages"
      },
      "cowork_session_count": {
        "type": "number",
        "title": "Cowork Sessions"
      },
      "cowork_message_count": {
        "type": "number",
        "title": "Cowork Messages"
      },
      "design_session_count": {
        "type": "number",
        "title": "Design Sessions"
      },
      "design_message_count": {
        "type": "number",
        "title": "Design Messages"
      }
    },
    "required": [
      "record_date"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_lines_changed": {
      "title": "Total Lines Changed",
      "calculation": ".properties.lines_added + .properties.lines_removed",
      "type": "number"
    },
    "edit_acceptance_rate": {
      "title": "Edit Acceptance Rate",
      "calculation": "if (.properties.edit_tool_accepted + .properties.edit_tool_rejected) > 0 then (.properties.edit_tool_accepted / (.properties.edit_tool_accepted + .properties.edit_tool_rejected)) * 100 else 0 end",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-ai-user-activity
  selector:
    query: 'true'
    timeFrame: 30
  port:
    entity:
      mappings:
        identifier: .user.id + "-" + .__date
        title: (.user.email_address // .user.id) + " - " + .__date
        blueprint: '"claude_ai_user_activity"'
        properties:
          record_date: .__date + "T00:00:00Z"
          user_id: .user.id
          email: .user.email_address
          chat_conversation_count: (.chat_metrics.distinct_conversation_count // 0)
          chat_message_count: (.chat_metrics.message_count // 0)
          chat_thinking_message_count: (.chat_metrics.thinking_message_count // 0)
          chat_skills_used_count: (.chat_metrics.distinct_skills_used_count // 0)
          chat_connectors_used_count: (.chat_metrics.connectors_used_count // 0)
          code_session_count: (.claude_code_metrics.core_metrics.distinct_session_count // 0)
          code_commit_count: (.claude_code_metrics.core_metrics.commit_count // 0)
          code_pull_request_count: (.claude_code_metrics.core_metrics.pull_request_count // 0)
          lines_added: (.claude_code_metrics.core_metrics.lines_of_code.added_count // 0)
          lines_removed: (.claude_code_metrics.core_metrics.lines_of_code.removed_count // 0)
          edit_tool_accepted: (.claude_code_metrics.tool_actions.edit_tool.accepted_count // 0)
          edit_tool_rejected: (.claude_code_metrics.tool_actions.edit_tool.rejected_count // 0)
          write_tool_accepted: (.claude_code_metrics.tool_actions.write_tool.accepted_count // 0)
          write_tool_rejected: (.claude_code_metrics.tool_actions.write_tool.rejected_count // 0)
          multi_edit_tool_accepted: (.claude_code_metrics.tool_actions.multi_edit_tool.accepted_count // 0)
          multi_edit_tool_rejected: (.claude_code_metrics.tool_actions.multi_edit_tool.rejected_count // 0)
          notebook_edit_tool_accepted: (.claude_code_metrics.tool_actions.notebook_edit_tool.accepted_count // 0)
          notebook_edit_tool_rejected: (.claude_code_metrics.tool_actions.notebook_edit_tool.rejected_count // 0)
          web_search_count: (.web_search_count // 0)
          chat_projects_used_count: (.chat_metrics.distinct_projects_used_count // 0)
          chat_projects_created_count: (.chat_metrics.distinct_projects_created_count // 0)
          chat_artifacts_created_count: (.chat_metrics.distinct_artifacts_created_count // 0)
          chat_files_uploaded_count: (.chat_metrics.distinct_files_uploaded_count // 0)
          chat_shared_conversations_viewed_count: (.chat_metrics.shared_conversations_viewed_count // 0)
          office_session_count: >-
            ([.office_metrics.excel.distinct_session_count,
            .office_metrics.powerpoint.distinct_session_count,
            .office_metrics.word.distinct_session_count,
            .office_metrics.outlook.distinct_session_count] | map(. // 0) | add)
          office_message_count: >-
            ([.office_metrics.excel.message_count,
            .office_metrics.powerpoint.message_count,
            .office_metrics.word.message_count,
            .office_metrics.outlook.message_count] | map(. // 0) | add)
          cowork_session_count: (.cowork_metrics.distinct_session_count // 0)
          cowork_message_count: (.cowork_metrics.message_count // 0)
          design_session_count: (.design_metrics.distinct_session_count // 0)
          design_message_count: (.design_metrics.message_count // 0)

{
  "user": {
    "id": "user_01VxtsnMPZAsxdeoXJB9BFp1",
    "email_address": "dev@domain.io"
  },
  "distinct_user_count": null,
  "chat_metrics": {
    "distinct_conversation_count": 2,
    "message_count": 4,
    "thinking_message_count": 0,
    "distinct_projects_used_count": 0,
    "distinct_projects_created_count": 0,
    "distinct_artifacts_created_count": 0,
    "distinct_skills_used_count": 0,
    "connectors_used_count": 0,
    "distinct_files_uploaded_count": 0,
    "shared_conversations_viewed_count": 0,
    "distinct_shared_artifacts_viewed_count": 0
  },
  "claude_code_metrics": {
    "core_metrics": {
      "distinct_session_count": 0,
      "commit_count": 0,
      "pull_request_count": 0,
      "lines_of_code": {
        "added_count": 0,
        "removed_count": 0
      }
    },
    "tool_actions": {
      "edit_tool": {
        "accepted_count": 0,
        "rejected_count": 0
      },
      "multi_edit_tool": {
        "accepted_count": 0,
        "rejected_count": 0
      },
      "write_tool": {
        "accepted_count": 0,
        "rejected_count": 0
      },
      "notebook_edit_tool": {
        "accepted_count": 0,
        "rejected_count": 0
      }
    }
  },
  "office_metrics": {
    "excel": {
      "distinct_session_count": 0,
      "message_count": 0,
      "skills_used_count": 0,
      "distinct_skills_used_count": 0,
      "connectors_used_count": 0,
      "distinct_connectors_used_count": 0
    },
    "powerpoint": {
      "distinct_session_count": 0,
      "message_count": 0,
      "skills_used_count": 0,
      "distinct_skills_used_count": 0,
      "connectors_used_count": 0,
      "distinct_connectors_used_count": 0
    },
    "word": {
      "distinct_session_count": 0,
      "message_count": 0,
      "skills_used_count": 0,
      "distinct_skills_used_count": 0,
      "connectors_used_count": 0,
      "distinct_connectors_used_count": 0
    },
    "outlook": {
      "distinct_session_count": 0,
      "message_count": 0,
      "skills_used_count": 0,
      "distinct_skills_used_count": 0,
      "connectors_used_count": 0,
      "distinct_connectors_used_count": 0
    }
  },
  "cowork_metrics": {
    "distinct_session_count": 0,
    "action_count": 0,
    "file_edit_count": null,
    "edit_tool_count": null,
    "multi_edit_tool_count": null,
    "write_tool_count": null,
    "notebook_edit_tool_count": null,
    "sessions_with_file_edits_count": null,
    "dispatch_turn_count": 0,
    "message_count": 0,
    "skills_used_count": 0,
    "distinct_skills_used_count": 0,
    "connectors_used_count": 0,
    "distinct_connectors_used_count": 0
  },
  "design_metrics": {
    "distinct_session_count": 0,
    "distinct_projects_used_count": 0,
    "distinct_projects_created_count": 0,
    "message_count": 0
  },
  "web_search_count": 0,
  "__date": "2026-05-14"
}

{
  "identifier": "claude_ai_user_usage",
  "description": "Per-user token usage across a date range",
  "title": "Claude AI User Usage",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Range Start (UTC)"
      },
      "range_end": {
        "type": "string",
        "format": "date-time",
        "title": "Range End (UTC)"
      },
      "user_id": {
        "type": "string",
        "title": "User ID"
      },
      "user_name": {
        "type": "string",
        "title": "User Name"
      },
      "email": {
        "type": "string",
        "format": "user",
        "title": "Email"
      },
      "deleted": {
        "type": "boolean",
        "title": "Deleted User"
      },
      "product": {
        "type": "string",
        "title": "Product"
      },
      "model": {
        "type": "string",
        "title": "Model"
      },
      "context_window": {
        "type": "string",
        "title": "Context Window"
      },
      "inference_geo": {
        "type": "string",
        "title": "Inference Geo"
      },
      "speed": {
        "type": "string",
        "title": "Speed"
      },
      "uncached_input_tokens": {
        "type": "number",
        "title": "Uncached Input Tokens"
      },
      "cache_creation_1h_tokens": {
        "type": "number",
        "title": "Cache Creation (1hr) Tokens"
      },
      "cache_creation_5m_tokens": {
        "type": "number",
        "title": "Cache Creation (5min) Tokens"
      },
      "cache_read_input_tokens": {
        "type": "number",
        "title": "Cache Read Input Tokens"
      },
      "output_tokens": {
        "type": "number",
        "title": "Output Tokens"
      },
      "total_tokens": {
        "type": "number",
        "title": "Total Tokens"
      },
      "web_search_requests": {
        "type": "number",
        "title": "Web Search Requests"
      },
      "requests": {
        "type": "number",
        "title": "Requests"
      }
    },
    "required": [
      "record_date"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_input_tokens": {
      "title": "Total Input Tokens",
      "description": "Sum of uncached input and cache read tokens",
      "calculation": ".properties.uncached_input_tokens + .properties.cache_read_input_tokens",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-ai-user-usage
  selector:
    query: 'true'
    startingAt: '2026-01-01T00:00:00Z'
  port:
    entity:
      mappings:
        identifier: >-
          .actor.user_id + "-" + .__starting_at[:10] + "-" + (.product // "all")
          + "-" + (.model // "all")
        title: (.actor.name // .actor.email // .actor.user_id) + " - " + .__starting_at[:10]
        blueprint: '"claude_ai_user_usage"'
        properties:
          record_date: .__starting_at
          range_end: .__ending_at
          user_id: .actor.user_id
          user_name: .actor.name
          email: .actor.email
          deleted: (.actor.deleted // false)
          product: .product
          model: .model
          context_window: .context_window
          inference_geo: .inference_geo
          speed: .speed
          uncached_input_tokens: (.uncached_input_tokens // 0)
          cache_creation_1h_tokens: (.cache_creation.ephemeral_1h_input_tokens // 0)
          cache_creation_5m_tokens: (.cache_creation.ephemeral_5m_input_tokens // 0)
          cache_read_input_tokens: (.cache_read_input_tokens // 0)
          output_tokens: (.output_tokens // 0)
          total_tokens: (.total_tokens // 0)
          web_search_requests: (.server_tool_use.web_search_requests // 0)
          requests: (.requests // 0)

{
  "product": null,
  "model": null,
  "context_window": null,
  "inference_geo": null,
  "speed": null,
  "slack_channel_id": null,
  "starting_at": null,
  "ending_at": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01NeewegJNLKFDPGpYhvhus8",
    "name": "Oded Doek",
    "email": "dev@domain.io",
    "deleted": false
  },
  "uncached_input_tokens": 889770,
  "cache_creation": {
    "ephemeral_1h_input_tokens": 10563402,
    "ephemeral_5m_input_tokens": 3777036
  },
  "cache_read_input_tokens": 734635224,
  "output_tokens": 2649149,
  "total_tokens": 752514581,
  "server_tool_use": {
    "web_search_requests": 22
  },
  "requests": 5048,
  "__starting_at": "2026-05-15T22:24:54Z",
  "__ending_at": "2026-06-15T22:24:54Z"
}

{
  "identifier": "claude_ai_user_cost",
  "description": "Per-user USD cost across a date range",
  "title": "Claude AI User Cost",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Range Start (UTC)"
      },
      "range_end": {
        "type": "string",
        "format": "date-time",
        "title": "Range End (UTC)"
      },
      "user_id": {
        "type": "string",
        "title": "User ID"
      },
      "user_name": {
        "type": "string",
        "title": "User Name"
      },
      "email": {
        "type": "string",
        "format": "user",
        "title": "Email"
      },
      "deleted": {
        "type": "boolean",
        "title": "Deleted User"
      },
      "product": {
        "type": "string",
        "title": "Product"
      },
      "model": {
        "type": "string",
        "title": "Model"
      },
      "currency": {
        "type": "string",
        "title": "Currency"
      },
      "amount": {
        "type": "number",
        "title": "Discounted Amount"
      },
      "list_amount": {
        "type": "number",
        "title": "List Amount"
      },
      "requests": {
        "type": "number",
        "title": "Requests"
      }
    },
    "required": [
      "record_date"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "discount_amount": {
      "title": "Discount Amount",
      "description": "List price minus discounted price",
      "calculation": ".properties.list_amount - .properties.amount",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-ai-user-cost
  selector:
    query: 'true'
    startingAt: '2026-01-01T00:00:00Z'
  port:
    entity:
      mappings:
        identifier: >-
          .actor.user_id + "-" + .__starting_at[:10] + "-" + (.product // "all")
          + "-" + (.model // "all")
        title: (.actor.name // .actor.email // .actor.user_id) + " - " + .__starting_at[:10]
        blueprint: '"claude_ai_user_cost"'
        properties:
          record_date: .__starting_at
          range_end: .__ending_at
          user_id: .actor.user_id
          user_name: .actor.name
          email: .actor.email
          deleted: (.actor.deleted // false)
          product: .product
          model: .model
          currency: (.currency // "USD")
          amount: ((.amount // "0") | tonumber) / 100
          list_amount: ((.list_amount // "0") | tonumber) / 100
          requests: (.requests // 0)

{
  "product": null,
  "model": null,
  "context_window": null,
  "inference_geo": null,
  "speed": null,
  "slack_channel_id": null,
  "starting_at": null,
  "ending_at": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01Vj49ahTgzCedehnXJBhatu",
    "name": "Aaron Taylor",
    "email": "dev@domain.io",
    "deleted": false
  },
  "currency": "USD",
  "amount": "53865.538742",
  "list_amount": "54964.570145",
  "cost_type": null,
  "token_type": null,
  "requests": 6380,
  "__starting_at": "2026-05-15T22:25:03Z",
  "__ending_at": "2026-06-15T22:25:03Z"
}

Claude Platform

{
  "identifier": "claude_platform_usage_record",
  "description": "Daily Claude Platform API usage metrics",
  "title": "Claude Platform Usage Record",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "uncached_input_tokens": {
        "type": "number",
        "title": "Uncached Input Tokens"
      },
      "output_tokens": {
        "type": "number",
        "title": "Output Tokens"
      },
      "cache_read_input_tokens": {
        "type": "number",
        "title": "Cache Read Input Tokens"
      },
      "cache_creation_5m_tokens": {
        "type": "number",
        "title": "Cache Creation (5min) Tokens"
      },
      "cache_creation_1h_tokens": {
        "type": "number",
        "title": "Cache Creation (1hr) Tokens"
      },
      "web_search_requests": {
        "type": "number",
        "title": "Web Search Requests"
      }
    },
    "required": [
      "record_date"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_input_tokens": {
      "title": "Total Input Tokens",
      "description": "Sum of uncached input and cache read tokens",
      "calculation": ".properties.uncached_input_tokens + .properties.cache_read_input_tokens",
      "type": "number"
    },
    "total_tokens": {
      "title": "Total Tokens",
      "description": "Sum of all input and output tokens",
      "calculation": ".properties.uncached_input_tokens + .properties.cache_read_input_tokens + .properties.output_tokens",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-platform-usage-record
  selector:
    query: .results | length > 0
    startingDate: '2026-01-01T00:00:00Z'
    bucketWidth: 1d
    groupBy: []
  port:
    entity:
      mappings:
        identifier: .starting_at[:10] + "-usage"
        title: '"Claude Usage - " + .starting_at[:10]'
        blueprint: '"claude_platform_usage_record"'
        properties:
          record_date: .starting_at
          uncached_input_tokens: (.results[0].uncached_input_tokens // 0)
          output_tokens: (.results[0].output_tokens // 0)
          cache_read_input_tokens: (.results[0].cache_read_input_tokens // 0)
          cache_creation_5m_tokens: (.results[0].cache_creation.ephemeral_5m_input_tokens // 0)
          cache_creation_1h_tokens: (.results[0].cache_creation.ephemeral_1h_input_tokens // 0)
          web_search_requests: (.results[0].server_tool_use.web_search_requests // 0)

{
  "starting_at": "2026-01-04T00:00:00Z",
  "ending_at": "2026-01-05T00:00:00Z",
  "results": [
    {
      "uncached_input_tokens": 10158,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 183637
      },
      "cache_read_input_tokens": 1207221,
      "output_tokens": 16925,
      "server_tool_use": {
        "web_search_requests": 0
      },
      "api_key_id": null,
      "workspace_id": null,
      "account_id": null,
      "service_account_id": null,
      "model": null,
      "service_tier": null,
      "context_window": null,
      "inference_geo": null
    }
  ]
}

{
  "identifier": "claude_platform_cost_record",
  "description": "Daily cost tracking for Claude Platform API usage",
  "title": "Claude Platform Cost Record",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "amount": {
        "type": "number",
        "title": "Cost Amount"
      },
      "currency": {
        "type": "string",
        "title": "Currency"
      }
    },
    "required": [
      "record_date"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {},
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-platform-cost-record
  selector:
    query: .results | length > 0
    startingDate: '2026-01-01T00:00:00Z'
    bucketWidth: 1d
  port:
    entity:
      mappings:
        identifier: .starting_at[:10] + "-cost"
        title: '"Claude Cost - " + .starting_at[:10]'
        blueprint: '"claude_platform_cost_record"'
        properties:
          record_date: .starting_at
          amount: ((.results[0].amount // "0") | tonumber)
          currency: (.results[0].currency // "USD")

{
  "starting_at": "2026-01-01T00:00:00Z",
  "ending_at": "2026-01-02T00:00:00Z",
  "results": [
    {
      "currency": "USD",
      "amount": "536.07566",
      "workspace_id": null,
      "description": null,
      "cost_type": null,
      "context_window": null,
      "model": null,
      "service_tier": null,
      "token_type": null,
      "inference_geo": null
    }
  ]
}

{
  "identifier": "claude_platform_workspace_usage",
  "description": "Usage metrics broken down by workspace",
  "title": "Claude Platform Workspace Usage",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "workspace_id": {
        "type": "string",
        "title": "Workspace ID"
      },
      "uncached_input_tokens": {
        "type": "number",
        "title": "Uncached Input Tokens"
      },
      "output_tokens": {
        "type": "number",
        "title": "Output Tokens"
      },
      "cache_read_input_tokens": {
        "type": "number",
        "title": "Cache Read Input Tokens"
      },
      "cache_creation_5m_tokens": {
        "type": "number",
        "title": "Cache Creation (5min) Tokens"
      },
      "cache_creation_1h_tokens": {
        "type": "number",
        "title": "Cache Creation (1hr) Tokens"
      },
      "web_search_requests": {
        "type": "number",
        "title": "Web Search Requests"
      }
    },
    "required": [
      "record_date",
      "workspace_id"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_tokens": {
      "title": "Total Tokens",
      "calculation": ".properties.uncached_input_tokens + .properties.cache_read_input_tokens + .properties.output_tokens",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-platform-usage-record
  selector:
    query: .results | length > 0
    startingDate: '2026-01-01T00:00:00Z'
    bucketWidth: 1d
    groupBy:
      - workspace_id
  port:
    itemsToParse: .results
    itemsToParseTopLevelTransform: false
    entity:
      mappings:
        identifier: (.item.workspace_id // "default") + "-" + .starting_at[:10]
        title: (.item.workspace_id // "default") + " - " + .starting_at[:10]
        blueprint: '"claude_platform_workspace_usage"'
        properties:
          record_date: .starting_at
          workspace_id: (.item.workspace_id // "default")
          uncached_input_tokens: (.item.uncached_input_tokens // 0)
          output_tokens: (.item.output_tokens // 0)
          cache_read_input_tokens: (.item.cache_read_input_tokens // 0)
          cache_creation_5m_tokens: (.item.cache_creation.ephemeral_5m_input_tokens // 0)
          cache_creation_1h_tokens: (.item.cache_creation.ephemeral_1h_input_tokens // 0)
          web_search_requests: (.item.server_tool_use.web_search_requests // 0)

{
  "starting_at": "2026-01-01T00:00:00Z",
  "ending_at": "2026-01-02T00:00:00Z",
  "results": [
    {
      "uncached_input_tokens": 163662,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 229562
      },
      "cache_read_input_tokens": 7287271,
      "output_tokens": 40898,
      "server_tool_use": {
        "web_search_requests": 0
      },
      "api_key_id": null,
      "workspace_id": "wrkspc_01R8i1bkxHiD5qiiY4SrhsRC",
      "account_id": null,
      "service_account_id": null,
      "model": null,
      "service_tier": null,
      "context_window": null,
      "inference_geo": null
    }
  ]
}

{
  "identifier": "claude_platform_model_usage",
  "description": "Usage metrics broken down by Claude model type",
  "title": "Claude Platform Model Usage",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "model": {
        "type": "string",
        "title": "Model"
      },
      "uncached_input_tokens": {
        "type": "number",
        "title": "Uncached Input Tokens"
      },
      "output_tokens": {
        "type": "number",
        "title": "Output Tokens"
      },
      "cache_read_input_tokens": {
        "type": "number",
        "title": "Cache Read Input Tokens"
      },
      "cache_creation_5m_tokens": {
        "type": "number",
        "title": "Cache Creation (5min) Tokens"
      },
      "cache_creation_1h_tokens": {
        "type": "number",
        "title": "Cache Creation (1hr) Tokens"
      },
      "web_search_requests": {
        "type": "number",
        "title": "Web Search Requests"
      }
    },
    "required": [
      "record_date",
      "model"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_tokens": {
      "title": "Total Tokens",
      "calculation": ".properties.uncached_input_tokens + .properties.cache_read_input_tokens + .properties.output_tokens",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-platform-usage-record
  selector:
    query: .results | length > 0
    startingDate: '2026-01-01T00:00:00Z'
    bucketWidth: 1d
    groupBy:
      - model
  port:
    itemsToParse: .results
    itemsToParseTopLevelTransform: false
    entity:
      mappings:
        identifier: .item.model + "-" + .starting_at[:10]
        title: .item.model + " - " + .starting_at[:10]
        blueprint: '"claude_platform_model_usage"'
        properties:
          record_date: .starting_at
          model: .item.model
          uncached_input_tokens: (.item.uncached_input_tokens // 0)
          output_tokens: (.item.output_tokens // 0)
          cache_read_input_tokens: (.item.cache_read_input_tokens // 0)
          cache_creation_5m_tokens: (.item.cache_creation.ephemeral_5m_input_tokens // 0)
          cache_creation_1h_tokens: (.item.cache_creation.ephemeral_1h_input_tokens // 0)
          web_search_requests: (.item.server_tool_use.web_search_requests // 0)

{
  "starting_at": "2026-01-04T00:00:00Z",
  "ending_at": "2026-01-05T00:00:00Z",
  "results": [
    {
      "uncached_input_tokens": 7678,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 35867
      },
      "cache_read_input_tokens": 74329,
      "output_tokens": 2435,
      "server_tool_use": {
        "web_search_requests": 0
      },
      "api_key_id": null,
      "workspace_id": null,
      "account_id": null,
      "service_account_id": null,
      "model": "claude-haiku-4-5-20251001",
      "service_tier": null,
      "context_window": null,
      "inference_geo": null
    },
    {
      "uncached_input_tokens": 1629,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 133486
      },
      "cache_read_input_tokens": 1132892,
      "output_tokens": 14321,
      "server_tool_use": {
        "web_search_requests": 0
      },
      "api_key_id": null,
      "workspace_id": null,
      "account_id": null,
      "service_account_id": null,
      "model": "claude-opus-4-5-20251101",
      "service_tier": null,
      "context_window": null,
      "inference_geo": null
    },
    {
      "uncached_input_tokens": 851,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 0,
        "ephemeral_5m_input_tokens": 14284
      },
      "cache_read_input_tokens": 0,
      "output_tokens": 169,
      "server_tool_use": {
        "web_search_requests": 0
      },
      "api_key_id": null,
      "workspace_id": null,
      "account_id": null,
      "service_account_id": null,
      "model": "claude-sonnet-4-5-20250929",
      "service_tier": null,
      "context_window": null,
      "inference_geo": null
    }
  ]
}

{
  "identifier": "claude_platform_code_analytics",
  "description": "Daily Claude Code usage metrics including sessions, lines of code, commits, and PRs",
  "title": "Claude Platform Code Analytics",
  "icon": "Claude",
  "schema": {
    "properties": {
      "record_date": {
        "type": "string",
        "format": "date-time",
        "title": "Record Date (UTC)"
      },
      "organization_id": {
        "type": "string",
        "title": "Organization ID"
      },
      "actor_type": {
        "type": "string",
        "title": "Actor Type"
      },
      "actor_name": {
        "type": "string",
        "title": "Actor Name"
      },
      "terminal_type": {
        "type": "string",
        "title": "Terminal Type"
      },
      "num_sessions": {
        "type": "number",
        "title": "Sessions"
      },
      "lines_added": {
        "type": "number",
        "title": "Lines Added"
      },
      "lines_removed": {
        "type": "number",
        "title": "Lines Removed"
      },
      "commits": {
        "type": "number",
        "title": "Commits by Claude Code"
      },
      "pull_requests": {
        "type": "number",
        "title": "Pull Requests by Claude Code"
      },
      "edit_tool_accepted": {
        "type": "number",
        "title": "Edit Tool Accepted"
      },
      "edit_tool_rejected": {
        "type": "number",
        "title": "Edit Tool Rejected"
      },
      "write_tool_accepted": {
        "type": "number",
        "title": "Write Tool Accepted"
      },
      "write_tool_rejected": {
        "type": "number",
        "title": "Write Tool Rejected"
      },
      "models_used": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "title": "Models Used"
      },
      "model_input_tokens": {
        "type": "number",
        "title": "Model Input Tokens"
      },
      "model_output_tokens": {
        "type": "number",
        "title": "Model Output Tokens"
      },
      "model_cache_read_tokens": {
        "type": "number",
        "title": "Model Cache Read Tokens"
      },
      "model_cache_creation_tokens": {
        "type": "number",
        "title": "Model Cache Creation Tokens"
      },
      "estimated_cost": {
        "type": "number",
        "title": "Estimated Cost (USD)"
      },
      "currency": {
        "type": "string",
        "title": "Currency"
      }
    },
    "required": [
      "record_date",
      "organization_id"
    ]
  },
  "mirrorProperties": {},
  "calculationProperties": {
    "total_lines_changed": {
      "title": "Total Lines Changed",
      "calculation": ".properties.lines_added + .properties.lines_removed",
      "type": "number"
    },
    "edit_acceptance_rate": {
      "title": "Edit Acceptance Rate",
      "calculation": "if (.properties.edit_tool_accepted + .properties.edit_tool_rejected) > 0 then (.properties.edit_tool_accepted / (.properties.edit_tool_accepted + .properties.edit_tool_rejected)) * 100 else 0 end",
      "type": "number"
    }
  },
  "aggregationProperties": {},
  "relations": {}
}

- kind: claude-platform-code-analytics
  selector:
    query: 'true'
    startingDate: '2026-01-01'
  port:
    entity:
      mappings:
        identifier: .organization_id + "-" + (.actor.api_key_name // .actor.email // "unknown") + "-" + .date[:10]
        title: (.actor.api_key_name // .actor.email // "unknown") + " - " + .date[:10]
        blueprint: '"claude_platform_code_analytics"'
        properties:
          record_date: .date
          organization_id: .organization_id
          actor_type: .actor.type
          actor_name: (.actor.api_key_name // .actor.email // "unknown")
          terminal_type: .terminal_type
          num_sessions: (.core_metrics.num_sessions // 0)
          lines_added: (.core_metrics.lines_of_code.added // 0)
          lines_removed: (.core_metrics.lines_of_code.removed // 0)
          commits: (.core_metrics.commits_by_claude_code // 0)
          pull_requests: (.core_metrics.pull_requests_by_claude_code // 0)
          edit_tool_accepted: (.tool_actions.edit_tool.accepted // 0)
          edit_tool_rejected: (.tool_actions.edit_tool.rejected // 0)
          write_tool_accepted: (.tool_actions.write_tool.accepted // 0)
          write_tool_rejected: (.tool_actions.write_tool.rejected // 0)
          models_used: ([(.model_breakdown // [])[].model] | unique)
          model_input_tokens: ([(.model_breakdown // [])[].tokens.input] | map(. // 0) | add)
          model_output_tokens: ([(.model_breakdown // [])[].tokens.output] | map(. // 0) | add)
          model_cache_read_tokens: ([(.model_breakdown // [])[].tokens.cache_read] | map(. // 0) | add)
          model_cache_creation_tokens: ([(.model_breakdown // [])[].tokens.cache_creation] | map(. // 0) | add)
          estimated_cost: ([(.model_breakdown // [])[].estimated_cost.amount] | map(. // 0) | add)
          currency: ((.model_breakdown // [])[0].estimated_cost.currency // "USD")

{
  "date": "2026-01-01T00:00:00Z",
  "actor": {
    "type": "api_actor",
    "api_key_name": "matan-tdd-agent"
  },
  "organization_id": "6d236493-6408-4d45-bc06-c65f19c17ba9",
  "terminal_type": "iTerm.app",
  "customer_type": "api",
  "subscription_type": null,
  "core_metrics": {
    "num_sessions": 1,
    "lines_of_code": {
      "added": 508,
      "removed": 61
    },
    "commits_by_claude_code": 0,
    "pull_requests_by_claude_code": 0
  },
  "tool_actions": {
    "edit_tool": {
      "accepted": 10,
      "rejected": 0
    },
    "multi_edit_tool": {
      "accepted": 0,
      "rejected": 0
    },
    "write_tool": {
      "accepted": 3,
      "rejected": 0
    },
    "notebook_edit_tool": {
      "accepted": 0,
      "rejected": 0
    }
  },
  "model_breakdown": [
    {
      "model": "claude-opus-4-5-20251101",
      "tokens": {
        "input": 1231,
        "output": 2207,
        "cache_read": 0,
        "cache_creation": 0
      },
      "estimated_cost": {
        "currency": "USD",
        "amount": 6
      }
    },
    {
      "model": "claude-opus-4-5",
      "tokens": {
        "input": 12,
        "output": 26406,
        "cache_read": 6494720,
        "cache_creation": 160361
      },
      "estimated_cost": {
        "currency": "USD",
        "amount": 491
      }
    },
    {
      "model": "claude-haiku-4-5-20251001",
      "tokens": {
        "input": 162419,
        "output": 12285,
        "cache_read": 792551,
        "cache_creation": 69201
      },
      "estimated_cost": {
        "currency": "USD",
        "amount": 39
      }
    }
  ]
}

Monitoring and sync status

To learn more about how to monitor and check the sync status of your integration, see the relevant documentation.

Migration guide

If you currently ingest Claude metrics through a custom Ocean integration, migrate to the dedicated Claude AI integration:

1. Create the new Claude AI data source from your data sources page.
2. Copy your existing Claude API credentials into the new integration setup.
3. Move your custom blueprint and mapping configuration into the dedicated integration.
4. Run a sync and validate that records are ingested for all enabled resources.
5. Disable the legacy custom Ocean Claude integration after validation.

Related guide

Visualize Claude metrics