[{"data":1,"prerenderedAt":477},["ShallowReactive",2],{"navigation_docs":3,"-docs-getting-started-introduction":150,"-docs-getting-started-introduction-surround":474},[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":11,"body":152,"description":468,"extension":469,"links":470,"meta":471,"navigation":274,"path":12,"seo":472,"stem":13,"__hash__":473},"docs\u002Fdocs\u002F1.getting-started\u002F1.introduction.md",{"type":153,"value":154,"toc":463},"minimark",[155,159,162,167,214,218,226,438,442,445,453,459],[156,157,158],"p",{},"Vigie watches a running app and tells you what is wrong in plain sentences: which requests fail and why, which background jobs are stuck, which provider is refusing calls, and what to do about it. You run it yourself, on your laptop or one small server. Your telemetry never leaves your machines.",[156,160,161],{},"It is built for Node apps. Adonis and NestJS connect with one command. Anything that speaks OpenTelemetry works too, in any language.",[163,164,166],"h2",{"id":165},"what-you-get","What you get",[168,169,170,178,184,190,196,202,208],"ul",{},[171,172,173,177],"li",{},[174,175,176],"strong",{},"Requests."," Every request is one wide event: route, status, duration, user, and whatever your code adds. Joined to its trace, its database queries and the calls it made to other services.",[171,179,180,183],{},[174,181,182],{},"Tasks."," Background jobs, with every attempt, its outcome and why it failed, skipped or will retry. What is stuck, what runs late, which worker died.",[171,185,186,189],{},[174,187,188],{},"Issues."," Errors grouped by cause, with the why and the fix in plain words, from your app or from rules you write.",[171,191,192,195],{},[174,193,194],{},"Processes."," Flows that cross several jobs, such as \"from payment to parcel\", with a funnel and the instances stuck in each step.",[171,197,198,201],{},[174,199,200],{},"Alerts."," On error rates, latency, stuck tasks, metrics, missing activity or any SQL. Sent to Slack, email, signed webhooks or Linear.",[171,203,204,207],{},[174,205,206],{},"Status page."," A public page that says in one sentence what is wrong and what still works, with 90 days of history.",[171,209,210,213],{},[174,211,212],{},"MCP."," Agents read the same screens you do, through more than a hundred tools, and can act on them with a write token.",[163,215,217],{"id":216},"your-app-in-code","Your app, in code",[156,219,220,221,225],{},"Everything specific to your app lives in ",[222,223,224],"code",{},"definitions\u002F",", as TypeScript files next to your app's code: how an event reads, what a process looks like, which alerts exist, what the status page shows. They are reviewed in pull requests, deployed with the app, and reload as soon as you save.",[227,228,234],"pre",{"className":229,"code":230,"filename":231,"language":232,"meta":233,"style":233},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineAlert } from 'vigie\u002Fsdk'\n\nexport const checkoutErrors = defineAlert({\n  id: 'checkout-errors',\n  name: 'Checkout failing',\n  family: 'Requests',\n  when: { source: 'request-error-rate' },\n  above: 2,\n  window: '10m',\n  unit: '%',\n})\n","definitions\u002Falerts\u002Facme.ts","ts","",[222,235,236,269,276,301,322,339,356,381,395,412,429],{"__ignoreMap":233},[237,238,241,245,249,253,256,259,262,266],"span",{"class":239,"line":240},"line",1,[237,242,244],{"class":243},"s7zQu","import",[237,246,248],{"class":247},"sMK4o"," {",[237,250,252],{"class":251},"sTEyZ"," defineAlert",[237,254,255],{"class":247}," }",[237,257,258],{"class":243}," from",[237,260,261],{"class":247}," '",[237,263,265],{"class":264},"sfazB","vigie\u002Fsdk",[237,267,268],{"class":247},"'\n",[237,270,272],{"class":239,"line":271},2,[237,273,275],{"emptyLinePlaceholder":274},true,"\n",[237,277,279,282,286,289,292,295,298],{"class":239,"line":278},3,[237,280,281],{"class":243},"export",[237,283,285],{"class":284},"spNyl"," const",[237,287,288],{"class":251}," checkoutErrors ",[237,290,291],{"class":247},"=",[237,293,252],{"class":294},"s2Zo4",[237,296,297],{"class":251},"(",[237,299,300],{"class":247},"{\n",[237,302,304,308,311,313,316,319],{"class":239,"line":303},4,[237,305,307],{"class":306},"swJcz","  id",[237,309,310],{"class":247},":",[237,312,261],{"class":247},[237,314,315],{"class":264},"checkout-errors",[237,317,318],{"class":247},"'",[237,320,321],{"class":247},",\n",[237,323,325,328,330,332,335,337],{"class":239,"line":324},5,[237,326,327],{"class":306},"  name",[237,329,310],{"class":247},[237,331,261],{"class":247},[237,333,334],{"class":264},"Checkout failing",[237,336,318],{"class":247},[237,338,321],{"class":247},[237,340,342,345,347,349,352,354],{"class":239,"line":341},6,[237,343,344],{"class":306},"  family",[237,346,310],{"class":247},[237,348,261],{"class":247},[237,350,351],{"class":264},"Requests",[237,353,318],{"class":247},[237,355,321],{"class":247},[237,357,359,362,364,366,369,371,373,376,378],{"class":239,"line":358},7,[237,360,361],{"class":306},"  when",[237,363,310],{"class":247},[237,365,248],{"class":247},[237,367,368],{"class":306}," source",[237,370,310],{"class":247},[237,372,261],{"class":247},[237,374,375],{"class":264},"request-error-rate",[237,377,318],{"class":247},[237,379,380],{"class":247}," },\n",[237,382,384,387,389,393],{"class":239,"line":383},8,[237,385,386],{"class":306},"  above",[237,388,310],{"class":247},[237,390,392],{"class":391},"sbssI"," 2",[237,394,321],{"class":247},[237,396,398,401,403,405,408,410],{"class":239,"line":397},9,[237,399,400],{"class":306},"  window",[237,402,310],{"class":247},[237,404,261],{"class":247},[237,406,407],{"class":264},"10m",[237,409,318],{"class":247},[237,411,321],{"class":247},[237,413,415,418,420,422,425,427],{"class":239,"line":414},10,[237,416,417],{"class":306},"  unit",[237,419,310],{"class":247},[237,421,261],{"class":247},[237,423,424],{"class":264},"%",[237,426,318],{"class":247},[237,428,321],{"class":247},[237,430,432,435],{"class":239,"line":431},11,[237,433,434],{"class":247},"}",[237,436,437],{"class":251},")\n",[163,439,441],{"id":440},"how-it-is-built","How it is built",[156,443,444],{},"One Bun process holds ingest, the app, alerts, MCP and your definitions. ClickHouse stores the telemetry and SQLite keeps the state: people, alerts, issues, incidents. Ingest speaks OTLP over HTTP, so any OpenTelemetry SDK can send to it.",[446,447,448,449,452],"note",{},"Vigie reads standard OpenTelemetry. The Adonis and NestJS packages are shortcuts, not requirements. See ",[450,451,38],"a",{"href":39},".",[156,454,455,456,452],{},"Next: ",[450,457,458],{"href":16},"run it on your machine",[460,461,462],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":233,"searchDepth":271,"depth":271,"links":464},[465,466,467],{"id":165,"depth":271,"text":166},{"id":216,"depth":271,"text":217},{"id":440,"depth":271,"text":441},"Vigie is self-hosted telemetry for Node apps. Logs, traces, tasks, alerts, a status page and MCP, in one small process with ClickHouse behind it.","md",null,{},{"title":11,"description":468},"BLn_Jv9Bp9bW3ypDSdoTOP9nF7N2yGefzAk82ln-lyU",[470,475],{"title":15,"path":16,"stem":17,"description":476,"children":-1},"Run Vigie on your machine with one command, then connect an app.",1795043961789]