Checked on Izumi 0.5.7, 2026-11-21: ./tb status and /metrics live on a throwaway stack, and /healthz, /readyz and /metrics without a token also on production.Izumi has two public health checks, a list of metrics for Prometheus, the ./tb status command and a status block in the app. Nothing is sent outside the server.
Not checked live yet: /metrics with a token on production (the token is a secret and was not used). On the throwaway stack it passed: /metrics without a token answers 401, with TB_METRICS_TOKEN 200, and ./tb status prints readyz: ready, the active model and the age of the last copy.
Health checks
GET /healthz: the process is running. Answers 200.
GET /readyz: 200 when the database is reachable, the migrations are current, the embedder answers and the worker heartbeat is younger than 2 minutes. Otherwise 503. The body has checks for db, schema, embedder and worker.
On production: /healthz returns 200, and /readyz returns {"ok":true,"checks":{"db":true,"schema":true,"embedder":true,"worker":true}}.
Metrics (/metrics)
GET /metrics returns Prometheus text with the header Authorization: Bearer <TB_METRICS_TOKEN>.
Without TB_METRICS_TOKEN set: 404 (the same as an unknown address).
Without the header or with a wrong token: 401, and it counts as a failed token check (tb_auth_failures_total). When the gate is full, the answer is 429.
Production has a token: a call without the header returns 401.
The response carries no company name, person, title or path.
tb_oauth_cimd_fetch_total (by host and outcome, see OAuth)
The ./tb status command
./tb status
It shows the containers (docker compose ps), readiness (readyz: ready or readyz: not ready), the active embedder model (active embed model: ...) and the age of the last backup (last backup: <file> (<n> h ago)). Set an alarm for a backup older than one day.
Status in the app
A company admin sees a status block at the top of the Sources page: whether the worker and the embedder are running, how many jobs are waiting and running, and the last error per source.
Logs and disk
docker compose logs app worker: logs are JSON lines, the level is set by TB_LOG_LEVEL. No secret is written to the log.
Disk: df -h and sudo du -sh backups.
Limits
/metrics is not available without TB_METRICS_TOKEN.
Izumi does not send alarms: you set up alarms in your own monitoring tool.
Troubleshooting
What you see
What to check
/readyz 503
The body says which checks is false. docker compose ps, then docker compose logs of that service.
/metrics answers 404
TB_METRICS_TOKEN is not set in .env.
/metrics answers 401
The Authorization: Bearer ... header is missing or the token is wrong.
worker is false in /readyz
The worker heartbeat is older than 2 minutes: docker compose logs worker.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Izumi","colors":{"primary":"#ff6b35","light":"#ff6b35","dark":"#0b0c0e"},"logo":{"light":"https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/logo/light.svg?fit=max\u0026auto=format\u0026n=-l5XLI7ftc2U1SZX\u0026q=85\u0026s=96af7cf3d62f98290e82d9b350a9e3f9","dark":"https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/logo/dark.svg?fit=max\u0026auto=format\u0026n=-l5XLI7ftc2U1SZX\u0026q=85\u0026s=c30d00f6d1a891b28bff5b756eb7e523","href":"https://izumi.akiaconsulting.com"},"favicon":"https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/favicon.svg?fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=a74575c718248bf0aceb8785ebfd9868","navbar":{"primary":{"type":"button","label":"Prijava / Sign in","href":"https://izumi.akiaconsulting.com"}},"footer":{"links":[{"header":"Izumi","items":[{"label":"izumi.akiaconsulting.com","href":"https://izumi.akiaconsulting.com"},{"label":"Akia Consulting","href":"https://akiaconsulting.com"}]}]},"search":{"prompt":"Pretraga / Search..."},"seo":{"metatags":{"canonical":"https://docs.izumi.akiaconsulting.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"akia-consulting","hasAudioNarration":false,"actualSubdomain":"akia-consulting","customDomains":["docs.izumi.akiaconsulting.com"],"gitSource":{"type":"github","owner":"vuuribica","repo":"izumi-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6b004ee7d53e418143901602"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b01968c0d13a27bf2848752","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Installation","count":11},{"language":"default","tag":"Setting up","count":11},{"language":"default","tag":"Instalacija","count":11},{"language":"default","tag":"Postavljanje","count":11},{"language":"default","tag":"Administration","count":9},{"language":"default","tag":"Managing","count":9},{"language":"default","tag":"Administracija","count":9},{"language":"default","tag":"Upravljanje","count":9},{"language":"default","tag":"Using Izumi","count":8},{"language":"default","tag":"Everyday use","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"en/install/monitoring","slug":"/en/install/monitoring","pageMetadata":{"title":"Monitoring","description":"What to watch and how.","href":"/en/install/monitoring"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"What to watch and how.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Checked on Izumi 0.5.7, 2026-11-21: `,_jsx(_components.code,{children:`./tb status`}),` and `,_jsx(_components.code,{children:`/metrics`}),` live on a throwaway stack, and `,_jsx(_components.code,{children:`/healthz`}),`, `,_jsx(_components.code,{children:`/readyz`}),` and `,_jsx(_components.code,{children:`/metrics`}),` without a token also on production.`]}),`\n`,_jsxs(_components.p,{children:[`Izumi has two public health checks, a list of metrics for Prometheus, the `,_jsx(_components.code,{children:`./tb status`}),` command and a status block in the app. Nothing is sent outside the server.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Not checked live yet: `,_jsx(_components.code,{children:`/metrics`}),` with a token on production (the token is a secret and was not used). On the throwaway stack it passed: `,_jsx(_components.code,{children:`/metrics`}),` without a token answers 401, with `,_jsx(_components.code,{children:`TB_METRICS_TOKEN`}),` 200, and `,_jsx(_components.code,{children:`./tb status`}),` prints `,_jsx(_components.code,{children:`readyz: ready`}),`, the active model and the age of the last copy.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`health-checks`,children:`Health checks`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /healthz`}),`: the process is running. Answers 200.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /readyz`}),`: 200 when the database is reachable, the migrations are current, the embedder answers and the worker heartbeat is younger than 2 minutes. Otherwise 503. The body has `,_jsx(_components.code,{children:`checks`}),` for `,_jsx(_components.code,{children:`db`}),`, `,_jsx(_components.code,{children:`schema`}),`, `,_jsx(_components.code,{children:`embedder`}),` and `,_jsx(_components.code,{children:`worker`}),`.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`curl -s https://brain.example.com/healthz`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`curl -s https://brain.example.com/readyz`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`On production: `,_jsx(_components.code,{children:`/healthz`}),` returns 200, and `,_jsx(_components.code,{children:`/readyz`}),` returns `,_jsx(_components.code,{children:`{\"ok\":true,\"checks\":{\"db\":true,\"schema\":true,\"embedder\":true,\"worker\":true}}`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`metrics-/metrics`,children:`Metrics (/metrics)`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /metrics`}),` returns Prometheus text with the header `,_jsx(_components.code,{children:`Authorization: Bearer \u003cTB_METRICS_TOKEN>`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Without `,_jsx(_components.code,{children:`TB_METRICS_TOKEN`}),` set: 404 (the same as an unknown address).`]}),`\n`,_jsxs(_components.li,{children:[`Without the header or with a wrong token: 401, and it counts as a failed token check (`,_jsx(_components.code,{children:`tb_auth_failures_total`}),`). When the gate is full, the answer is 429.`]}),`\n`,_jsx(_components.li,{children:`Production has a token: a call without the header returns 401.`}),`\n`,_jsx(_components.li,{children:`The response carries no company name, person, title or path.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Some of the metrics:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`tb_http_request_duration_seconds`}),`, `,_jsx(_components.code,{children:`tb_mcp_tool_duration_seconds`}),`, `,_jsx(_components.code,{children:`tb_embed_duration_seconds`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`tb_ingest_queue_depth`}),`, `,_jsx(_components.code,{children:`tb_jobs`}),`, `,_jsx(_components.code,{children:`tb_source_errors`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`tb_auth_failures_total`}),`, `,_jsx(_components.code,{children:`tb_audit_rows_last_minute`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`tb_oauth_cimd_fetch_total`}),` (by host and outcome, see `,_jsx(_components.a,{href:`/en/install/oauth`,children:`OAuth`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-/tb-status-command`,children:`The ./tb status command`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`./tb status`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`It shows the containers (`,_jsx(_components.code,{children:`docker compose ps`}),`), readiness (`,_jsx(_components.code,{children:`readyz: ready`}),` or `,_jsx(_components.code,{children:`readyz: not ready`}),`), the active embedder model (`,_jsx(_components.code,{children:`active embed model: ...`}),`) and the age of the last backup (`,_jsx(_components.code,{children:`last backup: \u003cfile> (\u003cn> h ago)`}),`). Set an alarm for a backup older than one day.`]}),`\n`,_jsx(Heading,{level:`2`,id:`status-in-the-app`,children:`Status in the app`}),`\n`,_jsxs(_components.p,{children:[`A company admin sees a status block at the top of the `,_jsx(_components.strong,{children:`Sources`}),` page: whether the worker and the embedder are running, how many jobs are waiting and running, and the last error per source.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=3a5cc8d57539cbd27cbc25b0e84f51d7`,alt:`Izumi, the installation status block on the Sources page`,\"data-og-width\":`1672`,width:`1672`,\"data-og-height\":`312`,height:`312`,\"data-path\":`images/en/monitoring/01-installation-status.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=280\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=23247cd45be9351b73862c1542a19fcf 280w, https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=560\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=12591e29c97d9d5544c9138dd103b299 560w, https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=840\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=118cf41387743f9b1c5daad1d7a7b3c1 840w, https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=1100\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=ff0572f8e351f6cced663c175c164a21 1100w, https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=1650\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=109cd5ccea3aafd550855e7a4e772458 1650w, https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/monitoring/01-installation-status.png?w=2500\u0026fit=max\u0026auto=format\u0026n=UfDKk95B0JApANc6\u0026q=85\u0026s=a5c9546042ef4bde1d30ae7e9c018cc8 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`logs-and-disk`,children:`Logs and disk`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`docker compose logs app worker`}),`: logs are JSON lines, the level is set by `,_jsx(_components.code,{children:`TB_LOG_LEVEL`}),`. No secret is written to the log.`]}),`\n`,_jsxs(_components.li,{children:[`Disk: `,_jsx(_components.code,{children:`df -h`}),` and `,_jsx(_components.code,{children:`sudo du -sh backups`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`/metrics`}),` is not available without `,_jsx(_components.code,{children:`TB_METRICS_TOKEN`}),`.`]}),`\n`,_jsx(_components.li,{children:`Izumi does not send alarms: you set up alarms in your own monitoring tool.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What you see`}),_jsx(_components.th,{children:`What to check`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/readyz`}),` 503`]}),_jsxs(_components.td,{children:[`The body says which `,_jsx(_components.code,{children:`checks`}),` is `,_jsx(_components.code,{children:`false`}),`. `,_jsx(_components.code,{children:`docker compose ps`}),`, then `,_jsx(_components.code,{children:`docker compose logs`}),` of that service.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/metrics`}),` answers 404`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`TB_METRICS_TOKEN`}),` is not set in `,_jsx(_components.code,{children:`.env`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/metrics`}),` answers 401`]}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`Authorization: Bearer ...`}),` header is missing or the token is wrong.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`worker`}),` is `,_jsx(_components.code,{children:`false`}),` in `,_jsx(_components.code,{children:`/readyz`})]}),_jsxs(_components.td,{children:[`The worker heartbeat is older than 2 minutes: `,_jsx(_components.code,{children:`docker compose logs worker`}),`.`]})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Monitoring","description":"What to watch and how.","href":"/en/install/monitoring"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Health checks","slug":"health-checks","depth":2,"children":[]},{"title":"Metrics (/metrics)","slug":"metrics-/metrics","depth":2,"children":[]},{"title":"The ./tb status command","slug":"the-/tb-status-command","depth":2,"children":[]},{"title":"Status in the app","slug":"status-in-the-app","depth":2,"children":[]},{"title":"Logs and disk","slug":"logs-and-disk","depth":2,"children":[]},{"title":"Limits","slug":"limits","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"akia-consulting","siteName":"Izumi","title":"Monitoring - Izumi","navMaps":{"firstHrefInVersion":{"Srpski":{"href":"/sr/upoznaj/sta-je-izumi","matchLevel":4},"English":{"href":"/en/install/monitoring","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-21T12:41:29.962Z","originalFileLocation":"en/install/monitoring.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"What to watch and how.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Izumi\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Monitoring - Izumi\">\u003cmeta data-mint-head property=\"og:description\" content=\"What to watch and how.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Izumi\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.izumi.akiaconsulting.com/en/install/monitoring\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://akia-consulting.mintlify.site/_mintlify/api/og/v2?division=Setting+up\u0026amp;title=Monitoring\u0026amp;description=What+to+watch+and+how.\u0026amp;theme=12c8ef4e20932cca09adf228\u0026amp;signature=a9264b35f007d949794fb1061121ba825b67136c0d9948c453af197f5b638e57\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Monitoring - Izumi\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What to watch and how.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://akia-consulting.mintlify.site/_mintlify/api/og/v2?division=Setting+up\u0026amp;title=Monitoring\u0026amp;description=What+to+watch+and+how.\u0026amp;theme=12c8ef4e20932cca09adf228\u0026amp;signature=a9264b35f007d949794fb1061121ba825b67136c0d9948c453af197f5b638e57\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/akia-consulting/IZKlsOdu96JblZDm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Izumi\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff6b35\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.izumi.akiaconsulting.com/en/install/monitoring\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/install/monitoring.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.izumi.akiaconsulting.com/#organization\",\"name\":\"Izumi\",\"url\":\"https://docs.izumi.akiaconsulting.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/logo/light.svg?fit=max\u0026auto=format\u0026n=-l5XLI7ftc2U1SZX\u0026q=85\u0026s=96af7cf3d62f98290e82d9b350a9e3f9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.izumi.akiaconsulting.com#website\",\"name\":\"Izumi\",\"url\":\"https://docs.izumi.akiaconsulting.com\",\"publisher\":{\"@id\":\"https://docs.izumi.akiaconsulting.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring#webpage\",\"url\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring\",\"name\":\"Monitoring\",\"description\":\"What to watch and how.\",\"dateModified\":\"2026-11-21T12:41:29.962Z\",\"isPartOf\":{\"@id\":\"https://docs.izumi.akiaconsulting.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Setting up\",\"item\":\"https://docs.izumi.akiaconsulting.com/en/install/requirements\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Monitoring\",\"item\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring#article\",\"headline\":\"Monitoring\",\"name\":\"Monitoring\",\"description\":\"What to watch and how.\",\"url\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring\",\"mainEntityOfPage\":{\"@id\":\"https://docs.izumi.akiaconsulting.com/en/install/monitoring#webpage\"},\"dateModified\":\"2026-11-21T12:41:29.962Z\",\"publisher\":{\"@id\":\"https://docs.izumi.akiaconsulting.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.izumi.akiaconsulting.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Izumi\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Izumi\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/install/monitoring.md","siteName":"Izumi","nav":{"global":null,"versions":[{"version":"Srpski","default":true,"pages":[{"title":"Srpski","href":"/sr/upoznaj/sta-je-izumi"}]},{"version":"English","tabs":[{"tab":"Meet Izumi","pages":[{"title":"Meet Izumi","href":"/en/overview/what-is-izumi"}]},{"tab":"Using Izumi","pages":[{"title":"Using Izumi","href":"/en/using/search"}]},{"tab":"AI tools (MCP)","pages":[{"title":"AI tools (MCP)","href":"/en/ai-tools/overview"}]},{"tab":"Administration","pages":[{"title":"Administration","href":"/en/admin/people"}]},{"tab":"Installation","groups":[{"group":"Setting up","pages":[{"title":"Requirements","href":"/en/install/requirements"},{"title":"Install","href":"/en/install/install"},{"title":"First sign-in and admin","href":"/en/install/first-admin"},{"title":"Sign-in (Google, Entra)","href":"/en/install/sign-in"},{"title":"Connectors (Google Cloud, Microsoft Graph)","href":"/en/install/connectors"},{"title":"OAuth for MCP clients","href":"/en/install/oauth"},{"title":"TLS","href":"/en/install/tls"},{"title":"Backup and restore","href":"/en/install/backup"},{"title":"Upgrade","description":"How to move to a new version.","href":"/en/install/upgrade"},{"title":"Monitoring","href":"/en/install/monitoring"},{"title":"Running offline","description":"Install in a network without internet access.","href":"/en/install/offline"}]}]}]}]},"basePath":"","title":"Monitoring - Izumi","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}