Importing from export files

Embed
Preview of the card
<a href="https://watchtowerops.net/docs/exports"><img src="https://watchtowerops.net/docs/_api/public/orgs/aa5959cb-1a0b-4a9a-bc9a-913e7ac31cd9/spaces/b7aac181-9916-4805-b253-becc5fd2ca62/pages/20411a6d-8414-4127-b331-f340e0b9b829/social-card.svg?v=3e7ae33eec8b" alt="Importing from export files" width="600" height="315"></a>

wtctl import <source> --alerts <file> --dashboards <file> [--alertmanager <file>] [--apply] [--report <prefix>]

These importers read export files, so no vendor credentials are sent anywhere. A run is a dry run unless --apply is given and always writes the skip report.

Source

--alerts

--dashboards

Mapped to

newrelic

NerdGraph policies with NRQL conditions

dashboard JSON array

promql (Metric), error_rate (Transaction error percentage), log_count (Log, via the log translator); metric widgets

splunk

saved/searches?output_mode=json

none

log_count for count-threshold alerts; others listed

promrules, chronosphere

Prometheus rule file

none

promql alert rules; --alertmanager is sent to POST /v1/projects/{p}/routing:import-alertmanager (preview unless --apply)

sentry

{projects, metric_alerts, issue_alerts}

none

error_rate from failure_rate(); projects and issue alerts listed

honeycomb

triggers array

boards array (listed only)

trace_latency, trace_failure

dynatrace

Settings 2.0 metric events

dashboards array

promql; log processing rules listed

kibana

none

saved-objects NDJSON

logs panels via the KQL translator; ingest pipelines listed

Log pipelines are reported, never imported. Everything not mapped appears under Unsupported with its reason.

Sunset and acquired vendors

  • Opsgenie (end of sale), Splunk On-Call and Grafana OnCall OSS: see oncall.md.

  • Chronosphere: Prometheus rules and Grafana dashboards import as above.

  • Helicone (maintenance mode): export with npx @helicone/export --format jsonl, then wtctl import helicone --file export.jsonl --endpoint <gateway> --key <ingestion key> replays each request as a gen_ai span (model, tokens, cost, latency, user, properties; --dry-run counts only). Ids come from the Helicone response id, so a rerun is deduplicated. For new traffic, point the OpenLLMetry or OTLP exporter at the gateway.

  • Traceloop (ServiceNow), Galileo (Splunk Agent Observability): OTLP or OpenLLMetry instrumentation; change the exporter endpoint and key to the Watchtower gateway. OpenLLMetry spans are ingested as is (crates/wt-llm/src/openllmetry.rs).

sentry-cli

sentry-cli works unchanged against the Sentry-compatible API of a project. Point it at the project and use a project-admin API key (wtk_…, sent as Authorization: Bearer); the org and project names it sends are ignored, the project comes from the URL and the key:

export SENTRY_URL=https://<api host>/v1/projects/<project id>/sentry/
export SENTRY_AUTH_TOKEN=wtk_...
export SENTRY_ORG=any SENTRY_PROJECT=any

Command

Endpoint

Stored as

releases new, releases info, releases finalize

POST organizations/{org}/releases/, GET/PUT .../releases/{version}/

release (dateReleased sets the release time)

releases set-commits (--commit, --auto, --local)

PUT .../releases/{version}/ with refs or commits; GET organizations/{org}/repos/ lists the project's repository links

release commits

deploys new -e <env>

POST .../releases/{version}/deploys/

a succeeded deployment (an unknown environment is created)

sourcemaps upload (debug ids, artifact bundles)

chunk-upload, organizations/{org}/artifactbundle/assemble/

minified files and source maps by debug id and release

debug-files upload, upload-proguard

chunk-upload, projects/{org}/{project}/files/difs/assemble/

ELF, Mach-O, PDB, Breakpad and ProGuard files by debug id

Uploads go through chunks of 8 MiB (sha1-checked, gzip allowed) and assemble into files of at most 100 MiB, which are parsed and counted against the project's 5 GiB artifact quota like POST /v1/projects/{p}/artifacts. Bundles are zip archives read with bounded entry counts and sizes. Unassembled chunks are deleted after a day. Portable PDBs, IL2CPP line mappings, BCSymbolMaps and source bundles are accepted by the chunk endpoint but refused at assemble with an error state.

Updated