mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
419 lines
25 KiB
HTML
419 lines
25 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-sentry</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-sentry.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-sentry">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-sentry.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-sentry</h1><p class="lede">Hanzo Sentry is a self-hosted Sentry 24.2.0 deployment for error tracking and performance monitoring across all Hanzo, Lux, Zoo, and Pars services.</p><h1>Hanzo Sentry - Error Tracking & Performance Monitoring</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-o11y.md</code>, <code>hanzo/hanzo-kms.md</code>, <code>hanzo/hanzo-id.md</code>, <code>hanzo/hanzo-universe.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo Sentry is a <strong>self-hosted Sentry 24.2.0 deployment</strong> for error tracking and performance monitoring across all Hanzo, Lux, Zoo, and Pars services. It is a fork of <a href="https://github.com/getsentry/sentry">getsentry/sentry</a> with a custom Dockerfile branded for Hanzo, configured for OIDC SSO via hanzo.id, and deployed to the hanzo-k8s cluster.</p>
|
|
<h3>Why Hanzo Sentry?</h3>
|
|
<ul><li><strong>Self-hosted</strong>: Full control over data, no SaaS dependency</li><li><strong>Multi-tenant</strong>: Single instance serving four domains (hanzo, lux, pars, zoo)</li><li><strong>IAM integrated</strong>: OIDC SSO login via hanzo.id (<code>app-sentry</code> client)</li><li><strong>Secrets via KMS</strong>: All credentials synced from kms.hanzo.ai</li><li><strong>OTEL instrumented</strong>: Exports traces to the shared OTEL collector</li><li><strong>Shared infrastructure</strong>: Uses hanzo-sql (PostgreSQL) and shared Redis</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Backend</strong>: Python 3.11 (Django 5.x, Celery, DRF)</li><li><strong>Frontend</strong>: React + TypeScript (Webpack, Emotion CSS)</li><li><strong>Queue</strong>: Celery via Redis (or RabbitMQ if configured)</li><li><strong>Database</strong>: PostgreSQL via <code>hanzo-sql.hanzo.svc</code></li><li><strong>Cache</strong>: Redis via <code>redis.hanzo.svc</code></li><li><strong>Image</strong>: <code>ghcr.io/hanzoai/sentry:latest</code></li><li><strong>Base version</strong>: Sentry 24.2.0 (FSL-1.0-Apache-2.0 license)</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Fork of <code>getsentry/sentry</code>. Local clone at <code>~/work/hanzo/sentry/</code>. The GitHub repo <code>hanzoai/sentry</code> does not yet exist as a public fork -- currently origin points to <code>getsentry/sentry</code> and Hanzo customizations live in the <code>self-hosted/</code> directory and K8s manifests in <code>universe/infra/k8s/sentry/</code>.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Instrumenting Hanzo services with error tracking</li><li>Monitoring performance of API endpoints, workers, and frontends</li><li>Viewing crash reports, stack traces, and breadcrumbs</li><li>Setting up alerting rules for error spikes</li><li>Tracking release health across deployments</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>PostgreSQL</strong> via <code>hanzo-sql.hanzo.svc</code> (database <code>sentry</code>)</li><li><strong>Redis</strong> via <code>redis.hanzo.svc</code> (cache, queues, rate limits, buffers)</li><li><strong>KMS</strong> at kms.hanzo.ai for secret sync (secret-key, db-password, oidc-client-secret)</li><li><strong>IAM</strong> at hanzo.id with <code>app-sentry</code> OIDC client for SSO</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | UI | <code>https://sentry.hanzo.ai</code> | | Alt domains | <code>sentry.lux.network</code>, <code>sentry.pars.network</code>, <code>sentry.zoo.network</code> | | Port | 9000 (web), internal K8s service | | Image | <code>ghcr.io/hanzoai/sentry:latest</code> | | Base version | Sentry 24.2.0 | | Language | Python 3.11 + TypeScript | | K8s namespace | <code>hanzo</code> | | Deployments | <code>sentry-web</code> (2 replicas), <code>sentry-worker</code> (2 replicas), <code>sentry-cron</code> (1 replica) | | Database | <code>hanzo-sql.hanzo.svc:5432/sentry</code> | | Redis | <code>redis.hanzo.svc:6379</code> | | Auth | OIDC SSO via hanzo.id (<code>app-sentry</code>) | | KMS project | <code>hanzo-k8s-epiq</code>, path <code>/sentry</code> | | Local clone | <code>~/work/hanzo/sentry/</code> | | K8s manifests | <code>~/work/hanzo/universe/infra/k8s/sentry/</code> | | Health check | <code>GET /_health/</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Instrument a Python service</h3>
|
|
<pre><code class="lang-python">import sentry_sdk
|
|
|
|
sentry_sdk.init(
|
|
dsn="https://<key>@sentry.hanzo.ai/<project-id>",
|
|
traces_sample_rate=0.1,
|
|
environment="production",
|
|
release="[email protected]",
|
|
)</code></pre>
|
|
<h3>Instrument a Node.js service</h3>
|
|
<pre><code class="lang-javascript">const Sentry = require("@sentry/node");
|
|
|
|
Sentry.init({
|
|
dsn: "https://<key>@sentry.hanzo.ai/<project-id>",
|
|
tracesSampleRate: 0.1,
|
|
environment: "production",
|
|
release: "[email protected]",
|
|
});</code></pre>
|
|
<h3>Instrument a Go service</h3>
|
|
<pre><code class="lang-go">import "github.com/getsentry/sentry-go"
|
|
|
|
func main() {
|
|
sentry.Init(sentry.ClientOptions{
|
|
Dsn: "https://<key>@sentry.hanzo.ai/<project-id>",
|
|
TracesSampleRate: 0.1,
|
|
Environment: "production",
|
|
Release: "[email protected]",
|
|
})
|
|
defer sentry.Flush(2 * time.Second)
|
|
}</code></pre>
|
|
<h3>Docker Compose (local development)</h3>
|
|
<pre><code class="lang-yaml"># compose.yml
|
|
services:
|
|
sentry-web:
|
|
image: ghcr.io/hanzoai/sentry:latest
|
|
command: ["sentry", "run", "web"]
|
|
ports:
|
|
- "9000:9000"
|
|
environment:
|
|
SENTRY_SECRET_KEY: "${SENTRY_SECRET_KEY}"
|
|
SENTRY_POSTGRES_HOST: postgres
|
|
SENTRY_DB_NAME: sentry
|
|
SENTRY_DB_USER: sentry
|
|
SENTRY_DB_PASSWORD: "${SENTRY_DB_PASSWORD}"
|
|
SENTRY_REDIS_HOST: redis
|
|
|
|
sentry-worker:
|
|
image: ghcr.io/hanzoai/sentry:latest
|
|
command: ["sentry", "run", "worker"]
|
|
environment:
|
|
SENTRY_SECRET_KEY: "${SENTRY_SECRET_KEY}"
|
|
SENTRY_POSTGRES_HOST: postgres
|
|
SENTRY_DB_NAME: sentry
|
|
SENTRY_DB_USER: sentry
|
|
SENTRY_DB_PASSWORD: "${SENTRY_DB_PASSWORD}"
|
|
SENTRY_REDIS_HOST: redis
|
|
|
|
sentry-cron:
|
|
image: ghcr.io/hanzoai/sentry:latest
|
|
command: ["sentry", "run", "cron"]
|
|
environment:
|
|
SENTRY_SECRET_KEY: "${SENTRY_SECRET_KEY}"
|
|
SENTRY_POSTGRES_HOST: postgres
|
|
SENTRY_DB_NAME: sentry
|
|
SENTRY_DB_USER: sentry
|
|
SENTRY_DB_PASSWORD: "${SENTRY_DB_PASSWORD}"
|
|
SENTRY_REDIS_HOST: redis
|
|
|
|
postgres:
|
|
image: postgres:16
|
|
environment:
|
|
POSTGRES_DB: sentry
|
|
POSTGRES_USER: sentry
|
|
POSTGRES_PASSWORD: "${SENTRY_DB_PASSWORD}"
|
|
|
|
redis:
|
|
image: redis:7-alpine</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code> ┌──────────────────────────────────┐
|
|
│ K8s Ingress │
|
|
│ sentry.hanzo.ai │
|
|
│ sentry.lux.network │
|
|
│ sentry.pars.network │
|
|
│ sentry.zoo.network │
|
|
└───────────────┬──────────────────┘
|
|
│
|
|
┌───────────────▼──────────────────┐
|
|
│ sentry-web (2 replicas) │
|
|
│ Django + uWSGI on port 9000 │
|
|
└──┬────────────┬─────────────┬────┘
|
|
│ │ │
|
|
┌──────▼──┐ ┌─────▼─────┐ ┌───▼────────┐
|
|
│ Postgres │ │ Redis │ │ OTEL │
|
|
│ hanzo-sql│ │ (shared) │ │ Collector │
|
|
└─────────┘ └───────────┘ └────────────┘
|
|
│ │
|
|
┌──────▼──┐ ┌─────▼──────────────┐
|
|
│ sentry- │ │ sentry-worker │
|
|
│ cron │ │ (2 replicas, Celery) │
|
|
└─────────┘ └─────────────────────┘</code></pre>
|
|
<h3>Three Deployments</h3>
|
|
<p>| Component | Command | Replicas | Purpose | |-----------|---------|----------|---------| | <code>sentry-web</code> | <code>sentry run web</code> | 2 | Django web server (uWSGI) | | <code>sentry-worker</code> | <code>sentry run worker</code> | 2 | Celery async task processing | | <code>sentry-cron</code> | <code>sentry run cron</code> | 1 | Scheduled tasks (digests, cleanup) |</p>
|
|
<h3>Multi-Tenant Domains</h3>
|
|
<p>A single Sentry instance serves four domains via K8s Ingress. Each domain maps to a separate Sentry organization, allowing per-org project isolation:</p>
|
|
<ul><li><code>sentry.hanzo.ai</code> -- Hanzo AI services</li><li><code>sentry.lux.network</code> -- Lux blockchain nodes</li><li><code>sentry.pars.network</code> -- Pars network services</li><li><code>sentry.zoo.network</code> -- Zoo Labs experiments</li></ul>
|
|
<h3>Auth Flow</h3>
|
|
<p>SSO is via OIDC against hanzo.id:</p>
|
|
<ol><li>User visits <code>sentry.hanzo.ai</code> and clicks "SSO Login"</li><li>Redirected to <code>hanzo.id</code> for authentication (client <code>app-sentry</code>)</li><li>OIDC callback returns to Sentry with identity token</li><li>Sentry creates/links user account and grants org membership</li></ol>
|
|
<h3>Dockerfile Customizations</h3>
|
|
<p>The <code>self-hosted/Dockerfile</code> in the local clone contains Hanzo-specific changes:</p>
|
|
<ul><li>OCI labels with <code>[email protected]</code> maintainer and Hanzo branding</li><li>References <code>ghcr.io/hanzoai/sentry</code> as image source</li><li>Copies <code>self-hosted/sentry.conf.py</code> and <code>self-hosted/config.yml</code> into <code>/etc/sentry/</code></li><li>Entrypoint via <code>tini</code> + <code>gosu</code> for proper signal handling</li></ul>
|
|
<h3>KMS Secret Sync</h3>
|
|
<p>Secrets are managed via the <code>KMSSecret</code> CRD that syncs from <code>kms.hanzo.ai</code>:</p>
|
|
<pre><code class="lang-yaml"># kms-secrets.yaml
|
|
spec:
|
|
hostAPI: https://kms.hanzo.ai/api
|
|
managedSecretReference:
|
|
secretName: sentry-secrets
|
|
secretNamespace: hanzo
|
|
authentication:
|
|
universalAuth:
|
|
secretsScope:
|
|
projectSlug: hanzo-k8s-epiq
|
|
envSlug: prod
|
|
secretsPath: /sentry</code></pre>
|
|
<p>Required secrets: <code>secret-key</code>, <code>db-password</code>, <code>oidc-client-secret</code>, <code>commerce-api-key</code> (optional).</p>
|
|
<h3>Environment Variables</h3>
|
|
<pre><code class="lang-bash"># Database (PostgreSQL)
|
|
SENTRY_POSTGRES_HOST=hanzo-sql.hanzo.svc
|
|
SENTRY_DB_NAME=sentry
|
|
SENTRY_DB_USER=sentry
|
|
SENTRY_DB_PASSWORD=<from KMS>
|
|
SENTRY_DB_PORT=5432
|
|
|
|
# Redis
|
|
SENTRY_REDIS_HOST=redis.hanzo.svc
|
|
SENTRY_REDIS_PORT=6379
|
|
|
|
# Core
|
|
SENTRY_SECRET_KEY=<from KMS>
|
|
|
|
# OIDC SSO
|
|
SENTRY_OIDC_ENABLED=true
|
|
SENTRY_OIDC_ISSUER=https://hanzo.id
|
|
SENTRY_OIDC_CLIENT_ID=app-sentry
|
|
SENTRY_OIDC_CLIENT_SECRET=<from KMS>
|
|
|
|
# Observability
|
|
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector.hanzo.svc:4318
|
|
OTEL_SERVICE_NAME=sentry
|
|
|
|
# Optional: Commerce billing
|
|
HANZO_COMMERCE_URL=https://commerce.hanzo.ai
|
|
HANZO_COMMERCE_API_KEY=<from KMS></code></pre>
|
|
<h3>Local Development</h3>
|
|
<pre><code class="lang-bash">cd ~/work/hanzo/sentry
|
|
|
|
# Python setup (uses direnv + pyenv, not uv — upstream pattern)
|
|
make develop
|
|
|
|
# Run dependent services (Postgres, Redis, Kafka, etc.)
|
|
make run-dependent-services
|
|
|
|
# Apply database migrations
|
|
make apply-migrations
|
|
|
|
# Start web server
|
|
sentry run web
|
|
|
|
# In another terminal: start worker
|
|
sentry run worker
|
|
|
|
# Run Python tests
|
|
make test-python-ci
|
|
|
|
# Run JavaScript tests
|
|
make test-js</code></pre>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | OIDC login fails | <code>app-sentry</code> not configured in IAM | Create OIDC client at hanzo.id with redirect URI <code>https://sentry.hanzo.ai/auth/sso/</code> | | Redis connection error | Missing <code>SENTRY_REDIS_HOST</code> | Ensure <code>redis.hanzo.svc</code> is reachable in cluster | | <code>SENTRY_SECRET_KEY is undefined</code> | KMS sync not running | Verify <code>sentry-secrets</code> K8s secret exists in <code>hanzo</code> namespace | | Migration errors | DB not created | Run <code>sentry upgrade</code> to create tables and apply migrations | | Worker not processing | Celery not connected to broker | Check Redis connectivity or RabbitMQ config | | Health check failing | Sentry not fully started | Wait for <code>initialDelaySeconds</code> (60s); check logs for startup errors | | <code>npm ci</code> fails | Peer dep conflicts | Use <code>npm install</code> with <code>.npmrc</code> containing <code>legacy-peer-deps=true</code> |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-o11y.md</code> - Observability stack (OTEL, Prometheus, Grafana)</li><li><code>hanzo/hanzo-id.md</code> - IAM and OIDC SSO configuration</li><li><code>hanzo/hanzo-kms.md</code> - Secret management via KMSSecret CRDs</li><li><code>hanzo/hanzo-universe.md</code> - Production K8s infrastructure and manifests</li><li><code>hanzo/hanzo-database.md</code> - Shared PostgreSQL (hanzo-sql)</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: sentry, error-tracking, monitoring, observability, self-hosted <strong>Prerequisites</strong>: Kubernetes, PostgreSQL, Redis, OIDC basics</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-sentry.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |