promotion

This optional block configures timed promotion for all application log messages. Define it only once across the complete configuration. Promotion is enabled with a 60-second interval by default.

logging {
    promotion {
        interval 5m;
        enable true;
    }
}

Disabling promotion stops promoted log rows but does not disable or change the associated counters. If enable false and interval are both configured, promotion remains disabled.

When a message's normal level is filtered, Radiator promotes the first occurrence immediately and then at most one occurrence during each interval. A promoted row reports the number of intervening occurrences that were suppressed. Its promoted.original_level field identifies the message's normal level before promotion. The top-level level field identifies the emitted level. Every occurrence still increments the message counter.

Each log target writes an interval-opening occurrence at either its normal or promoted level. One target never receives the same occurrence at both levels.

Protocol error example

For example, Radiator records an Unsupported packet type RADIUS error at DEBUG and promotes it to WARN. A target configured with the usual loglevel info filters the normal DEBUG rows. It receives the first occurrence immediately at WARN:

{
  "timestamp": "2026-08-17T12:00:00.000000000Z",
  "level": "WARN",
  "instance_id": "R00",
  "row_id": "92fd1650-b599-4d81-b300-55a9253acc61",
  "namespace": ["server", "radius-udp", "RADIUS_UDP_1812"],
  "message": "Unsupported packet type",
  "fields": {
    "radius_packet_type": "255"
  },
  "promoted": {
    "original_level": "Debug",
    "suppressed": 0
  }
}

If the errors continue, the target receives the next promoted occurrence after the default one-minute interval:

{
  "timestamp": "2026-08-17T12:01:00.125000000Z",
  "level": "WARN",
  "instance_id": "R00",
  "row_id": "39c76452-8144-493b-b4af-907c108b8012",
  "namespace": ["server", "radius-udp", "RADIUS_UDP_1812"],
  "message": "Unsupported packet type",
  "fields": {
    "radius_packet_type": "255"
  },
  "promoted": {
    "original_level": "Debug",
    "suppressed": 124
  }
}

In this example, 124 occurrences happened after the first promoted row. The occurrence at 12:01:00 opens the next interval. All 126 occurrences, including both visible rows, increment the message counter.

Configure the interval and enable parameters inside this block.