[{"data":1,"prerenderedAt":338},["ShallowReactive",2],{"navigation_docs":3,"-docs-getting-started-how-it-works":150,"-docs-getting-started-how-it-works-surround":333},[4,23,41,99,128],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"Getting started","i-lucide-rocket","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F2.quickstart",{"title":19,"path":20,"stem":21},"How it works","\u002Fdocs\u002Fgetting-started\u002Fhow-it-works","docs\u002F1.getting-started\u002F3.how-it-works",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"Connect an app","i-lucide-plug","\u002Fdocs\u002Fconnect","docs\u002F2.connect",[29,33,37],{"title":30,"path":31,"stem":32},"Adonis","\u002Fdocs\u002Fconnect\u002Fadonis","docs\u002F2.connect\u002F1.adonis",{"title":34,"path":35,"stem":36},"NestJS","\u002Fdocs\u002Fconnect\u002Fnestjs","docs\u002F2.connect\u002F2.nestjs",{"title":38,"path":39,"stem":40},"Any stack, no SDK","\u002Fdocs\u002Fconnect\u002Fany-stack","docs\u002F2.connect\u002F3.any-stack",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":22},"Definitions","i-lucide-code","\u002Fdocs\u002Fdefinitions","docs\u002F3.definitions",[47,51,55,59,63,67,71,75,79,83,87,91,95],{"title":48,"path":49,"stem":50},"Overview","\u002Fdocs\u002Fdefinitions\u002Foverview","docs\u002F3.definitions\u002F01.overview",{"title":52,"path":53,"stem":54},"Log renderers","\u002Fdocs\u002Fdefinitions\u002Flog-renderers","docs\u002F3.definitions\u002F02.log-renderers",{"title":56,"path":57,"stem":58},"Error renderers","\u002Fdocs\u002Fdefinitions\u002Ferror-renderers","docs\u002F3.definitions\u002F03.error-renderers",{"title":60,"path":61,"stem":62},"Processes","\u002Fdocs\u002Fdefinitions\u002Fprocesses","docs\u002F3.definitions\u002F04.processes",{"title":64,"path":65,"stem":66},"Pages","\u002Fdocs\u002Fdefinitions\u002Fpages","docs\u002F3.definitions\u002F05.pages",{"title":68,"path":69,"stem":70},"Dashboards","\u002Fdocs\u002Fdefinitions\u002Fdashboards","docs\u002F3.definitions\u002F06.dashboards",{"title":72,"path":73,"stem":74},"Alerts","\u002Fdocs\u002Fdefinitions\u002Falerts","docs\u002F3.definitions\u002F07.alerts",{"title":76,"path":77,"stem":78},"Monitors","\u002Fdocs\u002Fdefinitions\u002Fmonitors","docs\u002F3.definitions\u002F08.monitors",{"title":80,"path":81,"stem":82},"Status page","\u002Fdocs\u002Fdefinitions\u002Fstatus-page","docs\u002F3.definitions\u002F09.status-page",{"title":84,"path":85,"stem":86},"Tools","\u002Fdocs\u002Fdefinitions\u002Ftools","docs\u002F3.definitions\u002F10.tools",{"title":88,"path":89,"stem":90},"Redactors","\u002Fdocs\u002Fdefinitions\u002Fredactors","docs\u002F3.definitions\u002F11.redactors",{"title":92,"path":93,"stem":94},"Catalog","\u002Fdocs\u002Fdefinitions\u002Fcatalog","docs\u002F3.definitions\u002F12.catalog",{"title":96,"path":97,"stem":98},"More definitions","\u002Fdocs\u002Fdefinitions\u002Fmore","docs\u002F3.definitions\u002F13.more",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":22},"Features","i-lucide-layers","\u002Fdocs\u002Ffeatures","docs\u002F4.features",[105,109,112,116,120,124],{"title":106,"path":107,"stem":108},"Tasks","\u002Fdocs\u002Ffeatures\u002Ftasks","docs\u002F4.features\u002F1.tasks",{"title":80,"path":110,"stem":111},"\u002Fdocs\u002Ffeatures\u002Fstatus-page","docs\u002F4.features\u002F2.status-page",{"title":113,"path":114,"stem":115},"Alerts and notifications","\u002Fdocs\u002Ffeatures\u002Falerts","docs\u002F4.features\u002F3.alerts",{"title":117,"path":118,"stem":119},"MCP","\u002Fdocs\u002Ffeatures\u002Fmcp","docs\u002F4.features\u002F4.mcp",{"title":121,"path":122,"stem":123},"Releases","\u002Fdocs\u002Ffeatures\u002Freleases","docs\u002F4.features\u002F5.releases",{"title":125,"path":126,"stem":127},"Ask Vigie","\u002Fdocs\u002Ffeatures\u002Fask-vigie","docs\u002F4.features\u002F6.ask-vigie",{"title":129,"icon":130,"path":131,"stem":132,"children":133,"page":22},"Self-hosting","i-lucide-server","\u002Fdocs\u002Fself-hosting","docs\u002F5.self-hosting",[134,138,142,146],{"title":135,"path":136,"stem":137},"Deploy","\u002Fdocs\u002Fself-hosting\u002Fdeploy","docs\u002F5.self-hosting\u002F1.deploy",{"title":139,"path":140,"stem":141},"Configuration","\u002Fdocs\u002Fself-hosting\u002Fconfiguration","docs\u002F5.self-hosting\u002F2.configuration",{"title":143,"path":144,"stem":145},"Security","\u002Fdocs\u002Fself-hosting\u002Fsecurity","docs\u002F5.self-hosting\u002F3.security",{"title":147,"path":148,"stem":149},"Backups and retention","\u002Fdocs\u002Fself-hosting\u002Fbackups","docs\u002F5.self-hosting\u002F4.backups",{"id":151,"title":19,"body":152,"description":326,"extension":327,"links":328,"meta":329,"navigation":330,"path":20,"seo":331,"stem":21,"__hash__":332},"docs\u002Fdocs\u002F1.getting-started\u002F3.how-it-works.md",{"type":153,"value":154,"toc":317},"minimark",[155,160,223,227,231,251,255,262,292,296,299,302],[156,157,159],"h2",{"id":158},"three-kinds-of-data","Three kinds of data",[161,162,163,179],"table",{},[164,165,166],"thead",{},[167,168,169,173,176],"tr",{},[170,171,172],"th",{},"Signal",[170,174,175],{},"What it is",[170,177,178],{},"Where it shows",[180,181,182,197,210],"tbody",{},[167,183,184,191,194],{},[185,186,187],"td",{},[188,189,190],"strong",{},"Wide events",[185,192,193],{},"One OpenTelemetry log record per unit of work, with every field that matters to it: a request, a task attempt, a cron run.",[185,195,196],{},"Logs, Requests, Tasks, Issues, Processes",[167,198,199,204,207],{},[185,200,201],{},[188,202,203],{},"Traces",[185,205,206],{},"Spans from OpenTelemetry instrumentation: the database queries, HTTP calls and queue operations inside a unit of work.",[185,208,209],{},"Traces, External calls, Database",[167,211,212,217,220],{},[185,213,214],{},[188,215,216],{},"Metrics",[185,218,219],{},"Gauges, sums and histograms: queue depth, heap, event loop delay.",[185,221,222],{},"Metrics, Overview, Alerts",[224,225,226],"p",{},"A wide event carries the trace id of the work it describes, so every request opens on its trace, and every slow query leads back to the request that ran it.",[156,228,230],{"id":229},"what-makes-an-event-a-request-or-a-task","What makes an event a request or a task",[224,232,233,234,238,239,242,243,246,247,250],{},"Vigie reads plain attributes. A log record with ",[235,236,237],"code",{},"method"," is a request. One with ",[235,240,241],{},"task.kind"," is a task attempt. One with ",[235,244,245],{},"operation"," is any other unit of work. The full list is on ",[248,249,38],"a",{"href":39},".",[156,252,254],{"id":253},"ingest","Ingest",[224,256,257,258,261],{},"Data arrives over OTLP\u002FHTTP, in JSON or protobuf, at ",[235,259,260],{},"\u003CVIGIE_URL>\u002Fotlp\u002Fv1\u002F{logs,traces,metrics}"," or on the ingest port (4318). Before anything is stored:",[263,264,265,282,289],"ol",{},[266,267,268,269,272,273,276,277,250],"li",{},"Secrets are masked: keys such as ",[235,270,271],{},"password"," or ",[235,274,275],{},"authorization",", tokens in URLs, and the paths you list with ",[248,278,279],{"href":89},[235,280,281],{},"defineRedactor",[266,283,284,288],{},[248,285,287],{"href":286},"\u002Fdocs\u002Fdefinitions\u002Fmore#enrichers","Enrichers"," add fields, such as an account name looked up from an id.",[266,290,291],{},"Rows are written to ClickHouse in batches. If ClickHouse is down, they are written to disk and replayed when it is back, so nothing is lost.",[156,293,295],{"id":294},"storage-and-retention","Storage and retention",[224,297,298],{},"Spans and metrics are kept 30 days, wide events 90 days, and the per-minute rollups 400 days. ClickHouse drops whole days at once, so retention costs nothing.",[156,300,42],{"id":301},"definitions",[224,303,304,305,308,309,312,313,316],{},"On start, and whenever a file changes, Vigie loads every ",[235,306,307],{},".ts"," file under ",[235,310,311],{},"definitions\u002F",". A broken file shows its error on ",[188,314,315],{},"Settings, Extensions",", and everything else keeps working.",{"title":318,"searchDepth":319,"depth":319,"links":320},"",2,[321,322,323,324,325],{"id":158,"depth":319,"text":159},{"id":229,"depth":319,"text":230},{"id":253,"depth":319,"text":254},{"id":294,"depth":319,"text":295},{"id":301,"depth":319,"text":42},"Wide events, traces and metrics, stored in ClickHouse and read through your definitions.","md",null,{},true,{"title":19,"description":326},"Fzm3KYR65KpYFwAufcAs-01MsYgwJAjDsdna1KNjH3o",[334,336],{"title":15,"path":16,"stem":17,"description":335,"children":-1},"Run Vigie on your machine with one command, then connect an app.",{"title":30,"path":31,"stem":32,"description":337,"children":-1},"Send an Adonis app's requests, errors, traces and background tasks to Vigie with one command.",1795043962290]