Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Claude Cowork

Claude Cowork exports telemetry from Anthropic’s service, so its OTLP endpoint must be reachable from the public internet. Beacon can print the settings you need for the Claude admin console and validate whether Cowork events are arriving in the local runtime log. 
beacon endpoint integrations claude-cowork [command]

​
Commands

print-config

Print Claude Cowork OTLP setup guidance.

setup

Print or create Claude Cowork OTLP admin settings.

status

Show Claude Cowork endpoint integration status.

validate

Validate whether Claude Cowork events are arriving.

​
Production setup

For ongoing use, run a customer-managed HTTPS OpenTelemetry Collector endpoint: 
https://otel.example.com
Generate Claude Cowork setup values: 
beacon endpoint integrations claude-cowork setup \
  --endpoint https://otel.example.com \
  --headers "Authorization=Bearer <token>" \
  --user \
  --open
Copy the generated values into the Claude Cowork monitoring settings:
Claude settingValue
OTLP endpointYour public HTTPS collector endpoint
OTLP protocolHTTP/protobuf
OTLP headersOptional, commonly Authorization=Bearer <token>
Resource attributesDefaults to deployment.environment=prod,service.name=claude-cowork
Recommended production shape:
  • Use a real DNS name with TLS, such as https://otel.company.com
  • Require authentication at the public edge
  • Terminate TLS at a hardened reverse proxy or load balancer
  • Forward OTLP HTTP paths such as /v1/logs, /v1/metrics, and /v1/traces to the Collector’s local 4318 receiver
  • Treat Cowork telemetry as sensitive because prompt text, tool parameters, file paths, user email addresses, model usage, and errors may be present before Beacon redaction or export

​
Local testing with ngrok

For demos, validation, or local development only, Beacon can create a temporary authenticated ngrok tunnel to the local OTLP HTTP receiver: 
beacon endpoint install --user
beacon endpoint integrations claude-cowork setup --ngrok --user --open
Do not use an ngrok URL, 127.0.0.1, or a laptop endpoint for production monitoring.

​
Flags

FlagDescription
--endpoint <url>Public OTLP HTTPS endpoint reachable by Claude Cowork
--headers <headers>Optional OTLP headers for Claude admin settings
--resource-attributes <attrs>Optional Claude Cowork resource attributes
--ngrokCreate a temporary authenticated ngrok tunnel to the local OTLP HTTP receiver
--openOpen Claude Cowork admin settings in a browser
--since <duration>Require a Cowork event within this duration, such as 10m. Validate only
--jsonPrint status as JSON. Status only