Setting the file. One moment.
Skill 12 · Authoring Log Alerts
Subchapter 12.2
references/volume-floor-alerts.mdMarkdown2 KBView on GitHub
threshold_operator: below)Use to alert when a service stops producing logs — a strong signal that the service is down, the logging pipeline is broken, or something upstream stopped sending traffic.
The baseline_stats.py script doesn’t suggest below-thresholds directly — derive it manually from the
script’s output. Don’t compute by hand; use Python:
python3 -c "import sys, json; d=json.load(sys.stdin); print(max(1, round(d['stats']['p50'] * (5/d['bucket_minutes']) * 0.25)))" < stats.jsonThe reasoning:
p50 from the script (the typical bucket count).window_minutes / bucket_minutes).threshold_operator: below.evaluation_periods: 3, datapoints_to_alarm: 3 (3-of-3) — require 3 consecutive quiet windows. A single
blip won’t fire.window_minutes: 15 minimum — 5-minute floor alerts on noisy services are unreliable.cooldown_minutes: 60 — once you know the service is quiet, no point re-paging every check.Floor alerts are easy to misconfigure into “fires every night.” Always run posthog:logs-alerts-simulate-create over -7d
before shipping. If fire_count > 0 and the user has not had outages in the last 7 days, the threshold is
too aggressive.