The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
<mxfile host="app.diagrams.net" version="29.3.6">
<diagram name="Page-1" id="auth-types-1">
<mxGraphModel dx="815" dy="558" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1650" pageHeight="720" math="0" shadow="0" adaptiveColors="auto">
<root>
<mxCell id="0" />
<mxCell id="1" parent="0" />
<mxCell id="sdk" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>App with Traceway SDK<br>or OTel exporter</b>" vertex="1">
<mxGeometry height="60" width="170" x="40" y="40" as="geometry" />
</mxCell>
<mxCell id="ci" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Build / CI</b><br><i>symbol upload</i>" vertex="1">
<mxGeometry height="60" width="170" x="40" y="150" as="geometry" />
</mxCell>
<mxCell id="user" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Dashboard user</b><br><i>browser</i>" vertex="1">
<mxGeometry height="70" width="170" x="40" y="280" as="geometry" />
</mxCell>
<mxCell id="cli" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>traceway CLI</b>" vertex="1">
<mxGeometry height="60" width="170" x="40" y="470" as="geometry" />
</mxCell>
<mxCell id="mcp" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>MCP client</b>" vertex="1">
<mxGeometry height="60" width="170" x="40" y="600" as="geometry" />
</mxCell>
<mxCell id="ptok" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Project token</b><br><i>non-expiring, per project</i>" vertex="1">
<mxGeometry height="60" width="220" x="280" y="40" as="geometry" />
</mxCell>
<mxCell id="smtok" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Source map token</b><br><i>non-expiring, per project</i>" vertex="1">
<mxGeometry height="60" width="220" x="280" y="150" as="geometry" />
</mxCell>
<mxCell id="jwt" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Dashboard JWT</b><br><i>7 days</i>" vertex="1">
<mxGeometry height="55" width="220" x="280" y="260" as="geometry" />
</mxCell>
<mxCell id="pat" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Personal access token twp_</b><br><i>SHA-256 hashed, optional expiry</i>" vertex="1">
<mxGeometry height="60" width="220" x="280" y="340" as="geometry" />
</mxCell>
<mxCell id="devflow" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Device flow (RFC 8628)</b><br><i>user approves the<br>user code at /device</i>" vertex="1">
<mxGeometry height="80" width="220" x="280" y="460" as="geometry" />
</mxCell>
<mxCell id="oauth" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>OAuth code + PKCE</b><br><i>RFC 7591 dynamic registration,<br>consent at /oauth/authorize,<br>single-use twa_ code (5 min)</i>" vertex="1">
<mxGeometry height="90" width="220" x="280" y="580" as="geometry" />
</mxCell>
<mxCell id="tokend" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>POST /api/auth/token</b><br><i>device_code, authorization_code,<br>refresh_token grants</i>" vertex="1">
<mxGeometry height="70" width="200" x="560" y="520" as="geometry" />
</mxCell>
<mxCell id="acc" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Access token</b><br><i>15-min JWT</i>" vertex="1">
<mxGeometry height="60" width="200" x="820" y="450" as="geometry" />
</mxCell>
<mxCell id="ref" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Refresh token twr_</b><br><i>90 days, rotating, family<br>revoked on reuse</i>" vertex="1">
<mxGeometry height="70" width="200" x="820" y="560" as="geometry" />
</mxCell>
<mxCell id="uca" parent="1" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f5f5f5;" value="<b>UseClientAuth</b>" vertex="1">
<mxGeometry height="50" width="190" x="1090" y="45" as="geometry" />
</mxCell>
<mxCell id="usma" parent="1" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f5f5f5;" value="<b>UseSourceMapAuth</b>" vertex="1">
<mxGeometry height="50" width="190" x="1090" y="155" as="geometry" />
</mxCell>
<mxCell id="uaa" parent="1" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f5f5f5;" value="<b>UseAppAuth</b><br><i>JWT or twp_ hash lookup</i>" vertex="1">
<mxGeometry height="60" width="190" x="1090" y="300" as="geometry" />
</mxCell>
<mxCell id="roles" parent="1" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#f5f5f5;" value="<b>Role middleware</b><br><i>RequireProjectAccess<br>RequireWriteAccess (blocks readonly)<br>RequireAdminAccess (owner, admin)</i>" vertex="1">
<mxGeometry height="90" width="190" x="1090" y="410" as="geometry" />
</mxCell>
<mxCell id="ingest" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Telemetry ingestion</b><br><i>/api/report, /api/otel/v1/*,<br>/api/profiles/ingest</i>" vertex="1">
<mxGeometry height="80" width="240" x="1340" y="30" as="geometry" />
</mxCell>
<mxCell id="symup" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Symbol uploads</b><br><i>/api/sourcemaps/upload,<br>/api/symbols/upload</i>" vertex="1">
<mxGeometry height="70" width="240" x="1340" y="145" as="geometry" />
</mxCell>
<mxCell id="app" parent="1" style="rounded=0;whiteSpace=wrap;html=1;" value="<b>Dashboard API + MCP server</b><br><i>scoped by organization role</i>" vertex="1">
<mxGeometry height="90" width="240" x="1340" y="320" as="geometry" />
</mxCell>
<mxCell id="e1" edge="1" parent="1" source="sdk" target="ptok" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e2" edge="1" parent="1" source="ptok" target="uca" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e3" edge="1" parent="1" source="uca" target="ingest" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e4" edge="1" parent="1" source="ci" target="smtok" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e5" edge="1" parent="1" source="smtok" target="usma" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e6" edge="1" parent="1" source="usma" target="symup" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e7" edge="1" parent="1" source="user" target="jwt" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.3;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e7l" connectable="0" parent="e7" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" value="login / SSO" vertex="1">
<mxGeometry relative="1" x="0" y="0" as="geometry">
<mxPoint x="0" y="-10" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="e8" edge="1" parent="1" source="user" target="pat" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.7;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e8l" connectable="0" parent="e8" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" value="account page" vertex="1">
<mxGeometry relative="1" x="0" y="0" as="geometry">
<mxPoint x="0" y="10" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="e9" edge="1" parent="1" source="jwt" target="uaa" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.35;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e10" edge="1" parent="1" source="pat" target="uaa" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.65;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e11" edge="1" parent="1" source="cli" target="devflow" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e12" edge="1" parent="1" source="mcp" target="oauth" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e13" edge="1" parent="1" source="devflow" target="tokend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.25;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e14" edge="1" parent="1" source="oauth" target="tokend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.75;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e15" edge="1" parent="1" source="tokend" target="acc" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.3;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e16" edge="1" parent="1" source="tokend" target="ref" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.7;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e17" edge="1" parent="1" source="ref" target="tokend" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;dashed=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="920" y="660" />
<mxPoint x="660" y="660" />
</Array>
</mxGeometry>
</mxCell>
<mxCell id="e17l" connectable="0" parent="e17" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" value="rotate" vertex="1">
<mxGeometry relative="1" x="0" y="0" as="geometry">
<mxPoint x="0" y="-10" as="offset" />
</mxGeometry>
</mxCell>
<mxCell id="e18" edge="1" parent="1" source="acc" target="uaa" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.25;entryY=1;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry">
<Array as="points">
<mxPoint x="920" y="385" />
<mxPoint x="1137" y="385" />
</Array>
</mxGeometry>
</mxCell>
<mxCell id="e19" edge="1" parent="1" source="uaa" target="roles" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=0.6;exitY=1;exitDx=0;exitDy=0;entryX=0.6;entryY=0;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
<mxCell id="e20" edge="1" parent="1" source="roles" target="app" style="edgeStyle=orthogonalEdgeStyle;rounded=0;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.75;entryDx=0;entryDy=0;">
<mxGeometry relative="1" as="geometry" />
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>