Skip to content

The only tool you need to know what is happening and how to fix it.

feat: updated docs for android symbolication (#227)

narrow-adventure09e2dedbe251
diff --git a/website/app/product/symbolication/page.tsx b/website/app/product/symbolication/page.tsx
index da7a9703..7dd4cbf9 100644
--- a/website/app/product/symbolication/page.tsx
+++ b/website/app/product/symbolication/page.tsx
@@ -1,7 +1,14 @@
import Link from "next/link";
import Image from "next/image";
import type { Metadata } from "next";
-import { Github, BookOpen, Workflow } from "lucide-react";
+import {
+ Github,
+ BookOpen,
+ Workflow,
+ FileText,
+ ArrowRight,
+ ArrowUpRight,
+} from "lucide-react";
import { Eyebrow } from "@/components/eyebrow";
import { SectionHead } from "@/components/section-head";
@@ -30,7 +37,48 @@ const BUNDLERS = [
"Cloudflare Workers",
];
+const RESOURCES = [
+ {
+ icon: Github,
+ label: "Browse the source",
+ meta: "tracewayapp/traceway",
+ href: GITHUB_URL,
+ external: true,
+ },
+ {
+ icon: Workflow,
+ label: "OTel Collector processor",
+ meta: "Drop-in for Honeycomb",
+ href: "https://docs.tracewayapp.com/symbolicator/opentelemetry",
+ external: true,
+ },
+ {
+ icon: BookOpen,
+ label: "Documentation",
+ meta: "Architecture & cache tiers",
+ href: "https://docs.tracewayapp.com/symbolicator",
+ external: true,
+ },
+ {
+ icon: FileText,
+ label: "System design write-up",
+ meta: "How the .tw format works",
+ href: "/blog/system-design-of-a-symbolicator",
+ external: false,
+ },
+];
+
const LANGUAGE_TILES = [
+ {
+ src: "/images/frameworks/android.png",
+ alt: "Android",
+ w: 45,
+ h: 45,
+ size: 56,
+ z: 20,
+ pos: "left-[20%] top-1/2 -translate-x-1/2 -translate-y-1/2",
+ engine: true,
+ },
{
src: "/images/frameworks/flutter.png",
alt: "Flutter",
@@ -38,17 +86,7 @@ const LANGUAGE_TILES = [
h: 40,
size: 80,
z: 22,
- pos: "left-[24%] top-1/2 -translate-x-1/2 -translate-y-1/2",
- engine: true,
- },
- {
- src: "/images/frameworks/android.png",
- alt: "Android",
- w: 45,
- h: 36,
- size: 80,
- z: 24,
- pos: "left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2",
+ pos: "left-[86%] top-1/2 -translate-x-1/2 -translate-y-1/2",
engine: true,
},
{
@@ -58,7 +96,7 @@ const LANGUAGE_TILES = [
h: 171,
size: 104,
z: 30,
- pos: "left-[76%] top-1/2 -translate-x-1/2 -translate-y-1/2",
+ pos: "left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2",
engine: true,
},
{
@@ -239,7 +277,7 @@ export default function SymbolicationPage() {
className="mt-4 text-[22px] leading-tight text-pretty"
style={{ color: "var(--fg-0)" }}
>
- JavaScript, Dart, Flutter, Swift, Android, and more coming soon.
+ JavaScript, Dart, Flutter, Swift, and Android.
</h3>
<p
className="mt-4 text-[15px] text-pretty"
@@ -249,9 +287,8 @@ export default function SymbolicationPage() {
obfuscation maps, iOS and Swift dSYM debug symbols, and Android
R8 mapping files through the same compiled cache, plus every JS
framework that ships them, from React and Svelte to Next.js and
- Remix. Even on the
- cheapest box we tested, a 2&nbsp;vCPU Hetzner <code>ccx13</code>
- , it clears{" "}
+ Remix. Even on the cheapest box we tested, a 2&nbsp;vCPU Hetzner{" "}
+ <code>ccx13</code>, it clears{" "}
<strong style={{ color: "var(--fg-0)" }}>
over 32&times; the stack traces per second
</strong>{" "}
@@ -278,7 +315,22 @@ export default function SymbolicationPage() {
Symbolication that <em>keeps up with ingest.</em>
</>
}
- description="Most symbolicators re-parse source maps on every restart and hold them in RAM until the process dies. Ours compiles each map once, then memory-maps it from disk. The numbers below come straight from the benchmark workflow in the repo, run head to head against Honeycomb's symbolicator on Hetzner hardware."
+ description={
+ <>
+ Most symbolicators re-parse source maps on every restart and
+ hold them in RAM until the process dies. Ours compiles each map
+ once, then memory-maps it from disk. The numbers below come
+ straight from the benchmark workflow in the repo, run head to
+ head against Honeycomb&rsquo;s symbolicator on Hetzner
+ hardware.{" "}
+ <Link
+ href="/blog/system-design-of-a-symbolicator"
+ className="font-medium text-[color:var(--a2)] hover:underline"
+ >
+ Read why the design is this efficient &rarr;
+ </Link>
+ </>
+ }
/>
<StatsStrip
stats={[
@@ -355,46 +407,37 @@ export default function SymbolicationPage() {
))}
</div>
</div>
- <div className="flex flex-wrap gap-x-6 gap-y-3 text-[13px]">
- <Link
- href={GITHUB_URL}
- target="_blank"
- rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 hover:text-[color:var(--a2)]"
- style={{
- color: "var(--fg-1)",
- fontFamily: "var(--font-mono)",
- }}
- >
- <Github className="h-3.5 w-3.5" />
- traceway →
- </Link>
- <Link
- href="https://docs.tracewayapp.com/symbolicator/opentelemetry"
- target="_blank"
- rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 hover:text-[color:var(--a2)]"
- style={{
- color: "var(--fg-1)",
- fontFamily: "var(--font-mono)",
- }}
- >
- <Workflow className="h-3.5 w-3.5" />
- OTel processor →
- </Link>
- <Link
- href="https://docs.tracewayapp.com/symbolicator"
- target="_blank"
- rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 hover:text-[color:var(--a2)]"
- style={{
- color: "var(--fg-1)",
- fontFamily: "var(--font-mono)",
- }}
- >
- <BookOpen className="h-3.5 w-3.5" />
- Documentation →
- </Link>
+ <div className="flex flex-col gap-0.5">
+ {RESOURCES.map(({ icon: Icon, label, meta, href, external }) => {
+ const Arrow = external ? ArrowUpRight : ArrowRight;
+ return (
+ <Link
+ key={label}
+ href={href}
+ {...(external
+ ? { target: "_blank", rel: "noopener noreferrer" }
+ : {})}
+ className="group flex items-start gap-3 rounded-lg px-3 py-2.5 hover:bg-[var(--ink-2)]"
+ >
+ <Icon className="mt-0.5 size-4 shrink-0 text-[color:var(--fg-3)] group-hover:text-[color:var(--a2)]" />
+ <span className="min-w-0 flex-1">
+ <span
+ className="flex items-center text-[13px] text-[color:var(--fg-1)] group-hover:text-[color:var(--a2)]"
+ style={{ fontFamily: "var(--font-mono)" }}
+ >
+ <span className="truncate">{label}</span>
+ <Arrow className="ml-auto size-4 shrink-0 text-[color:var(--fg-3)] transition-transform group-hover:translate-x-0.5 group-hover:text-[color:var(--a2)]" />
+ </span>
+ <span
+ className="mt-0.5 block truncate text-[12px]"
+ style={{ color: "var(--fg-3)" }}
+ >
+ {meta}
+ </span>
+ </span>
+ </Link>
+ );
+ })}
</div>
</div>
</div>
diff --git a/website/components/symbolication-before-after.tsx b/website/components/symbolication-before-after.tsx
index 7a5abb6e..606862e2 100644
--- a/website/components/symbolication-before-after.tsx
+++ b/website/components/symbolication-before-after.tsx
@@ -38,7 +38,7 @@ export function SymbolicationBeforeAfter() {
<section className="wrap pt-16 pb-4">
<div className="mx-auto grid max-w-5xl items-center gap-6 md:grid-cols-[1fr_auto_1fr] md:gap-5">
<div className="min-w-0">
- <CardLabel text="What the browser sends" />
+ <CardLabel text="What the client sends" />
<div
className="overflow-hidden rounded-xl px-6 py-5 text-[12px] leading-[1.7]"
style={{