Trace Identifier Normaliser

Overview

You send a log body and we return every trace id we recognise, each as lower-case 32-hex with the formats that matched it, where it first appears and how often. The formats are a closed list and there is no pattern field, because a caller-supplied expression over two megabytes is a denial of service with no safe version. The bare 32-hex and 16-hex formats are off unless you ask for them, since a bare hex run is equally likely to be a digest or a session token and returning tokens as trace ids is worse than returning nothing.

The same request carries a different-looking id in every hop: 32-hex in one service, 16-hex in the next, hyphenated in a third. Comparing them by eye is where correlation stops, and a hand-rolled pattern for the job is either wrong on the edges or a backtracking hazard on a large body.

When to use it

Scope

Non-goals

• Does not accept a caller-supplied pattern, ever
• Does not guess: bare hex runs are off unless you enable them
• Does not fetch a trace, call a backend or read a clock
• Does not redact the body or judge whether an id is sensitive
• Does not correlate ids across two separate calls

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"observability.normalize_trace_id","input":{"text":"traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("observability.normalize_trace_id", {"formats":["W3C_TRACEPARENT","HEX_32"],"text":"traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01\n"});

Errors

Other limits

Limitations

• Does not accept a caller-supplied pattern, ever
• Does not guess: bare hex runs are off unless you enable them
• Does not fetch a trace, call a backend or read a clock
• Does not redact the body or judge whether an id is sensitive
• Does not correlate ids across two separate calls
• Searching for an arbitrary identifier shape that is not one of the seven
• Extracting structured fields from logs, which the parse skills answer

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "observability.normalize_trace_id",
  "input": {
    "formats": [
      "W3C_TRACEPARENT",
      "HEX_32"
    ],
    "text": "traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01\n"
  }
}

Examples

{
  "formats": [
    "W3C_TRACEPARENT",
    "HEX_32"
  ],
  "text": "traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01\n"
}

{
  "summary": {
    "idCount": 1,
    "occurrenceCount": 1,
    "invalidCount": 0,
    "truncated": false,
    "invalidTruncated": false,
    "enabledFormats": [
      "W3C_TRACEPARENT",
      "HEX_32"
    ],
    "scannedBytes": 69,
    "maxBytesForEnabledFormats": 4194304
  },
  "invalid": [],
  "ids": [
    {
      "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
      "formats": [
        "W3C_TRACEPARENT",
        "HEX_32"
      ],
      "padded": false,
      "occurrences": 1,
      "firstLine": 1,
      "firstColumn": 14,
      "firstOffset": 13,
      "length": 55,
      "spanId": null,
      "parentId": "00f067aa0ba902b7",
      "sampled": "01",
      "formatVersion": "00",
      "xrayEpochHex": null
    }
  ]
}

{
  "formats": [
    "B3_SINGLE"
  ],
  "text": "b3=463ac35c9f6413ad-a2fb4a1d1a96d312-1\n"
}

{
  "summary": {
    "idCount": 1,
    "occurrenceCount": 1,
    "invalidCount": 0,
    "truncated": false,
    "invalidTruncated": false,
    "enabledFormats": [
      "B3_SINGLE"
    ],
    "scannedBytes": 39,
    "maxBytesForEnabledFormats": 8388608
  },
  "invalid": [],
  "ids": [
    {
      "traceId": "0000000000000000463ac35c9f6413ad",
      "formats": [
        "B3_SINGLE"
      ],
      "padded": true,
      "occurrences": 1,
      "firstLine": 1,
      "firstColumn": 4,
      "firstOffset": 3,
      "length": 35,
      "spanId": "a2fb4a1d1a96d312",
      "parentId": null,
      "sampled": "1",
      "formatVersion": null,
      "xrayEpochHex": null
    }
  ]
}

Recommended use cases

• Pull the trace ids out of a support-supplied log excerpt to look them up
• Reconcile ids written by services using W3C, B3 and X-Ray propagation

Avoid for

• Searching for an arbitrary identifier shape that is not one of the seven
• Extracting structured fields from logs, which the parse skills answer

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags