Sentry — co to je, principy a sběr chyb

Co je Sentry ve vývoji

Sentry je open-source platforma pro hlášení pádů a monitorování výkonu, založená v roce 2012. Umožňuje vývojářům přijímat oznámení o chybách v reálném čase s úplným diagnostickým kontextem: zásobník volání, hodnoty proměnných v okamžiku pádu, posloupnost akcí uživatele před chybou a stav prostředí.

Na rozdíl od agregovaných služeb hlášení pádů (Google Play Console, App Store Connect), které poskytují pouze statistiky a základní grafy, Sentry zobrazuje každou událost samostatně s možností seskupování podle typu chyby a filtrování podle verze aplikace. Issue v Sentry je skupina událostí se stejným stacktrace, což umožňuje neutopit se v tisících identických pádech, ale soustředit se na odstranění hlavní příčiny s úplným kontextem.

Podle Sentry (2025) se průměrná doba detekce chyby zkracuje z 30 minut na 30 sekund po zavedení Sentry SDK a doba diagnózy o 60 % díky automatickým breadcrumbs a kontextu prostředí. Platformu používá více než 100 000 organizací po celém světě, včetně Airbnb, Microsoft, Instagram a PayPal, zpracovávajících miliardy událostí denně.

Architektura Sentry: SDK, Relay a zpracování událostí

Systém Sentry se skládá ze tří hlavních komponent: SDK na straně aplikace, Relay (proxy server) a backendu pro zpracování událostí. Sentry SDK je knihovna integrovaná do aplikace, která zachycuje výjimky, shromažďuje kontext a odesílá události do Relay přes protokol JSON/HTTPS.

Sentry Relay

Relay je zprostředkující server, který může být nasazen v infrastruktuře společnosti. Přijímá události z SDK, filtruje podle pravidel (PII data, nepotřebné události), bufferuje a přeposílá do Sentry SaaS nebo vlastní instance. Relay zajišťuje nízkou latenci odesílání — typická doba přijetí události je 500–1500 ms.

Inbound Data Filter

Sentry poskytuje vestavěné filtry pro odmítání nežádoucích událostí bez jejich odesílání na server: chyby z testovacích prostředí, chyby ze starších verzí aplikace, opakované události se stejným fingerprintem. Filtering šetří až 70 % objemu dat v typickém produkčním projektu, snižuje náklady na spotřebu a zatížení komunikačního kanálu zařízení.

Nastavení Sentry SDK pro iOS a Android

Instalace Sentry SDK pro mobilní platformy trvá 5–10 minut a vyžaduje přidání závislosti a inicializaci s DSN klíčem. DSN (Data Source Name) je jedinečný identifikátor projektu v Sentry, který udává, kam události odesílat.

Nastavení na Androidu

Pro Android poskytuje Sentry automatickou instrumentaci prostřednictvím Gradle pluginu. Plugin upravuje bytecode ve fázi kompilace a přidává obálky pro všechny Activity, Fragment a síťová volání. Auto-instrumentation se zapíná jednou volbou v build.gradle a umožňuje získávat breadcrumbs z životního cyklu aplikace bez změny kódu.

import io.sentry.Sentry

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        Sentry.init { options ->
            options.dsn = "https://example@sentry.io/project"
            options.tracesSampleRate = 0.2
            options.enableAutoSessionTracking = true
        }
    }
}

Kód inicializuje Sentry SDK v Android aplikaci. Parametr tracesSampleRate = 0.2 zapíná performance tracing pro 20 % relací, enableAutoSessionTracking automaticky vytváří relace pro každé spuštění aplikace.

Nastavení na iOS

SDK pro iOS podporuje CocoaPods, Swift Package Manager a Carthage. Po instalaci SDK automaticky zachycuje NSException, signály (SIGABRT, SIGSEGV) a chyby Swift. Sentry Cocoa SDK je kompatibilní s iOS 12+ a macOS 10.13+, podporuje Swift Concurrency (async/await) a automatickou instrumentaci URLSession.

import Sentry

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        SentrySDK.start { options in
            options.dsn = "https://example@sentry.io/project"
            options.enableAutoPerformanceTracing = true
        }
        return true
    }
}

Kód v Swift aktivuje Sentry SDK s automatickým sběrem metrik výkonu. enableAutoPerformanceTracing zapíná monitorování doby načítání obrazovek a HTTP požadavků bez dalšího kódu.

Breadcrumbs a kontext chyby

Breadcrumbs je chronologická posloupnost událostí předcházejících chybě. Sentry automaticky zaznamenává breadcrumbs pro kliknutí na tlačítka, přechody mezi obrazovkami, HTTP požadavky a systémová oznámení. Vývojář může přidávat vlastní breadcrumbs pro obchodní logiku.

Každý breadcrumb obsahuje časové razítko, typ události (navigation, http, ui, error), kategorii a libovolná data. Při výskytu chyby jsou všechny breadcrumbs z posledních 2–5 minut (nastavitelné) připojeny k události. Tento kontext je často důležitější než samotný stacktrace: vývojář vidí, že uživatel klikl na „Zaplatit“ po výběru produktu a teprve poté došlo k pádu. Maximální počet breadcrumbs je ve výchozím nastavení 200, poté jsou nejstarší záznamy automaticky smazány.

Sentry.addBreadcrumb(
    Breadcrumb().apply {
        category = "payment"
        message = "User tapped Pay button"
        type = "user"
        level = BreadcrumbLevel.INFO
        data["amount"] = "19.99"
        data["currency"] = "USD"
    }
)

Kód přidává vlastní breadcrumb pro akci uživatele v platebním scénáři. Pokud po této akci dojde k chybě, vývojář uvidí v Sentry, že uživatel klikl na „Pay“ s částkou 19.99 USD, což umožňuje rychlou lokalizaci problému v platebním toku.

User context

Sentry umožňuje připojovat k událostem informace o uživateli: ID, uživatelské jméno, e-mail. User context je automaticky přenášen se všemi událostmi z jedné relace, což umožňuje seskupovat chyby podle uživatelů a určit, kolik uživatelů bylo zasaženo konkrétní chybou. Je důležité dodržovat zásady ochrany soukromí a neodesílat osobní údaje, pokud to politika aplikace nepovoluje.

Source maps a ladicí symboly

V produkčních verzích iOS a Android je kód obvykle minifikován nebo obfuskován. Bez zpracování bude zásobník chyb obsahovat nesrozumitelná jména jako „a.b()“ místo „UserViewModel.fetchData()“. Source maps (JavaScript) a debug symbols (dSYM pro iOS, ProGuard mapping pro Android) obnovují čitelný zásobník.

Pro Android Sentry automaticky nahrává soubory ProGuard mapping prostřednictvím Gradle pluginu při sestavování release verze. Pro iOS je vyžadováno nahrání dSYM souborů — Sentry poskytuje skript pro automatické nahrání ve fázi archivace. Bez ladicích symbolů bude zásobník chyb v Sentry pro vývojáře nepoužitelný, proto by proces jejich nahrávání měl být povinným krokem v CI/CD pipeline.

Monitorování výkonu přes Sentry

Od verze 2020 Sentry zahrnuje monitorování výkonu — sběr metrik doby provádění transakcí s distributed tracing. Transaction v Sentry je měřitelná jednotka práce: načítání obrazovky, provádění API požadavku, zpracování úlohy na pozadí. Každá transakce obsahuje podřízené span, které ukazují, které kroky zabraly nejvíce času.

Monitorování výkonu v Sentry je integrováno s error trackingem: pokud transakce skončí chybou, příslušný span je označen stavem „error“ a vývojář může přejít z metriky výkonu na podrobnosti výjimky. Trace ID spojuje všechny události (chyby, transakce, breadcrumbs) do jedné relace pro komplexní analýzu a zajišťuje bezproblémový přechod mezi kartami Issues a Performance na jednotném dashboardu platformy Sentry.

Podle Sentry Performance Benchmark (2024) aplikace s aktivovaným monitorováním výkonu (frekvence vzorkování 10 %) spotřebovává o 2–5 % více provozu a o 1–2 % více prostředků CPU na zařízení. Tato zátěž je kompenzována zkrácením doby diagnostiky výkonu o 70 % ve srovnání s ručním profilováním.