[{"data":1,"prerenderedAt":375},["ShallowReactive",2],{"doc-\u002Ftroubleshooting\u002Falert-catalog":3},{"id":4,"title":5,"body":6,"description":365,"edit":366,"extension":367,"meta":368,"navigation":369,"path":370,"seo":371,"stem":372,"vertical":366,"weight":373,"__hash__":374},"content\u002Ftroubleshooting\u002Falert-catalog.md","Alert catalog",{"type":7,"value":8,"toc":327},"minimark",[9,13,18,26,29,32,48,51,57,63,66,68,73,79,86,88,93,99,102,104,109,113,119,132,138,141,147,150,152,160,166,169,173,179,182,188,191,197,200,206,209,213,219,225,231,237,243,246,250,256,259,265,268,274,277,281,284,304,307,316],[10,11,12],"p",{},"A reference of the notification subjects you might see from\nOpenSense and what each one means. Sorted by severity then by\nfrequency.",[14,15,17],"h2",{"id":16},"channel-state-alerts","Channel-state alerts",[19,20,22],"h3",{"id":21},"alarm-channel-at-value-range-ok_minok_max",[23,24,25],"code",{},"🔴 ALARM — \u003Cchannel> at \u003Cvalue> (range \u003Cok_min>–\u003Cok_max>)",[10,27,28],{},"The channel has been out of operating range for longer than the\ngrace period. This is the load-bearing notification.",[10,30,31],{},"What to do:",[33,34,35,39,42,45],"ol",{},[36,37,38],"li",{},"Open the dashboard via the link in the message.",[36,40,41],{},"Inspect the chart for the last hour: is the value still out of\nrange, or did it bounce back?",[36,43,44],{},"If still out: investigate the physical world. Door open?\nEquipment failure? Power outage?",[36,46,47],{},"Acknowledge the event with a note.",[10,49,50],{},"Don't:",[52,53,54],"ul",{},[36,55,56],{},"Soften the threshold to make the alarm go away. That treats the\nsymptom, not the cause.",[19,58,60],{"id":59},"warn-channel-at-value-entering-grace",[23,61,62],{},"🟡 WARN — \u003Cchannel> at \u003Cvalue> (entering grace)",[10,64,65],{},"The channel just left the operating range. The grace period is\ncounting down; if it returns to range before grace expires, no\nalarm fires.",[10,67,31],{},[52,69,70],{},[36,71,72],{},"Often nothing; this is informational. If you see WARN frequently\nwith no ALARM, your grace period is well-tuned.",[19,74,76],{"id":75},"ok-channel-cleared",[23,77,78],{},"🟢 OK — \u003Cchannel> cleared",[10,80,81,82,85],{},"The channel returned to range. If an ALARM had fired, this also\nemits ",[23,83,84],{},"alarm_cleared"," in the audit trail.",[10,87,31],{},[52,89,90],{},[36,91,92],{},"Add a clearing note explaining the cause if known. \"Door closed\nby night manager at 22:45.\" The audit trail is more valuable\nwith notes.",[19,94,96],{"id":95},"silenced-channel-alarm-during-silence-window",[23,97,98],{},"⚫ SILENCED — \u003Cchannel> alarm during silence window",[10,100,101],{},"An alarm condition occurred during a configured silence window. No\nnotification was emitted (this one is the digest summary); the\naudit log records the event.",[10,103,31],{},[52,105,106],{},[36,107,108],{},"Confirm the silence window is correct. If alarms fire during\nsilence frequently, you may have a misconfigured window or an\nunderlying problem the silence is masking.",[14,110,112],{"id":111},"device-state-alerts","Device-state alerts",[19,114,116],{"id":115},"offline-device-no-data-for-δt",[23,117,118],{},"📡 OFFLINE — \u003Cdevice> no data for \u003CΔt>",[10,120,121,122,125,126,131],{},"The device has not reported in ",[23,123,124],{},"> 2 × cadence",". See\n",[127,128,130],"a",{"href":129},"\u002Ftroubleshooting\u002Fdevice-offline","device-offline",".",[19,133,135],{"id":134},"online-device-reconnected",[23,136,137],{},"📡 ONLINE — \u003Cdevice> reconnected",[10,139,140],{},"The device started reporting again. If readings were buffered (some\nESP32 firmware, all LoRaWAN), the gap may fill in retroactively.",[19,142,144],{"id":143},"battery-low-device-at-pctv",[23,145,146],{},"🔋 BATTERY LOW — \u003Cdevice> at \u003Cpct\u002FV>",[10,148,149],{},"Battery dropped below 20 % (Gen1) or 3.4 V (Gen3).",[10,151,31],{},[52,153,154,157],{},[36,155,156],{},"Replace the battery within a week.",[36,158,159],{},"For LoRaWAN, the device will run for ~1 month after this notice\nbefore going offline.",[19,161,163],{"id":162},"battery-critical-device-at-pctv",[23,164,165],{},"🔋 BATTERY CRITICAL — \u003Cdevice> at \u003Cpct\u002FV>",[10,167,168],{},"Battery below 5 % or 3.1 V. Replace today.",[14,170,172],{"id":171},"configuration-alerts","Configuration alerts",[19,174,176],{"id":175},"token-rotated-device",[23,177,178],{},"🔑 TOKEN ROTATED — \u003Cdevice>",[10,180,181],{},"An ingest token was rotated. Sent to the account holder; not to\noperators.",[19,183,185],{"id":184},"token-aged-device-token-365-d",[23,186,187],{},"🔑 TOKEN AGED — \u003Cdevice> token > 365 d",[10,189,190],{},"Reminder that the token has not been rotated in a year. Advisory,\nnot enforced.",[19,192,194],{"id":193},"rule-changed-channel",[23,195,196],{},"🛠 RULE CHANGED — \u003Cchannel>",[10,198,199],{},"A rule's threshold was edited. Sent to the audit log; sent as a\nnotification only if the account has subscribed to configuration\nevents.",[19,201,203],{"id":202},"silence-started-ended-channel",[23,204,205],{},"🔇 SILENCE STARTED \u002F ENDED — \u003Cchannel>",[10,207,208],{},"A silence window opened or closed. Informational; included in the\naccount-level digest.",[14,210,212],{"id":211},"account-state-alerts","Account-state alerts",[19,214,216],{"id":215},"invoice-paid",[23,217,218],{},"💳 INVOICE — paid",[19,220,222],{"id":221},"invoice-failed",[23,223,224],{},"💳 INVOICE — failed",[19,226,228],{"id":227},"trial-ending-days-left",[23,229,230],{},"💳 TRIAL ENDING — \u003Cdays> left",[19,232,234],{"id":233},"account-paused",[23,235,236],{},"💳 ACCOUNT PAUSED",[19,238,240],{"id":239},"account-deletion-scheduled-date",[23,241,242],{},"💳 ACCOUNT DELETION SCHEDULED — \u003Cdate>",[10,244,245],{},"Billing lifecycle. Sent to the account email only.",[14,247,249],{"id":248},"system-alerts","System alerts",[19,251,253],{"id":252},"ingest-degraded-region",[23,254,255],{},"⚙ INGEST DEGRADED — \u003Cregion>",[10,257,258],{},"Our ingest path is slow. Sent only if degradation lasts > 5 min.",[19,260,262],{"id":261},"ingest-down-region",[23,263,264],{},"⚙ INGEST DOWN — \u003Cregion>",[10,266,267],{},"Our ingest path is unreachable. Sent only if > 1 min. We send from\ninfrastructure independent of the ingest path; this notification\nsurvives our own outages.",[19,269,271],{"id":270},"maintenance-scheduled-date",[23,272,273],{},"⚙ MAINTENANCE — scheduled \u003Cdate>",[10,275,276],{},"Planned maintenance window. Sent 7 days in advance.",[14,278,280],{"id":279},"operator-alerts-if-telegram-bot-is-in-a-group","Operator alerts (if Telegram bot is in a group)",[10,282,283],{},"The bot may also reply to commands in groups:",[52,285,286,292,298],{},[36,287,288,291],{},[23,289,290],{},"\u002Fack \u003Cevent_id>"," → acknowledges the event with the sender as\nthe acknowledger.",[36,293,294,297],{},[23,295,296],{},"\u002Fsilence \u003Cchannel> \u003Cminutes>"," → opens a silence window.",[36,299,300,303],{},[23,301,302],{},"\u002Fstatus \u003Cchannel>"," → posts the current state and last 5\nreadings.",[10,305,306],{},"These commands log to the audit trail same as if done in the\ndashboard.",[14,308,310,311,315],{"id":309},"what-we-do-not-emit","What we do ",[312,313,314],"strong",{},"not"," emit",[52,317,318,321,324],{},[36,319,320],{},"Marketing emails. Ever.",[36,322,323],{},"\"Your data is healthy, no action required\" pings. (We deliberately\ndo not send these. Silence is success.)",[36,325,326],{},"\"Tips & tricks\" suggestions. (The docs are the docs; we will not\nping you to \"discover\" them.)",{"title":328,"searchDepth":329,"depth":329,"links":330},"",3,[331,338,344,350,357,362,363],{"id":16,"depth":332,"text":17,"children":333},2,[334,335,336,337],{"id":21,"depth":329,"text":25},{"id":59,"depth":329,"text":62},{"id":75,"depth":329,"text":78},{"id":95,"depth":329,"text":98},{"id":111,"depth":332,"text":112,"children":339},[340,341,342,343],{"id":115,"depth":329,"text":118},{"id":134,"depth":329,"text":137},{"id":143,"depth":329,"text":146},{"id":162,"depth":329,"text":165},{"id":171,"depth":332,"text":172,"children":345},[346,347,348,349],{"id":175,"depth":329,"text":178},{"id":184,"depth":329,"text":187},{"id":193,"depth":329,"text":196},{"id":202,"depth":329,"text":205},{"id":211,"depth":332,"text":212,"children":351},[352,353,354,355,356],{"id":215,"depth":329,"text":218},{"id":221,"depth":329,"text":224},{"id":227,"depth":329,"text":230},{"id":233,"depth":329,"text":236},{"id":239,"depth":329,"text":242},{"id":248,"depth":332,"text":249,"children":358},[359,360,361],{"id":252,"depth":329,"text":255},{"id":261,"depth":329,"text":264},{"id":270,"depth":329,"text":273},{"id":279,"depth":332,"text":280},{"id":309,"depth":332,"text":364},"What we do not emit","What every notification means",null,"md",{},true,"\u002Ftroubleshooting\u002Falert-catalog",{"title":5,"description":365},"troubleshooting\u002Falert-catalog",490,"iouGPqMqATw1c0rf86L1xY0Y3oHcHu3utq8uOK742S4",1779022955887]