Dokumentace

napojení SDK

Rychlý start

Endpointy odpovídají protokolu Sentry, takže platí dokumentace vašeho SDK. Jediné, co potřebujete, je DSN z detailu projektu (záložka Klíče).

terminál

curl -X POST \
  https://api.webovahlidka.cz/api/<projekt>/store/ \
  -H 'X-Sentry-Auth: Sentry sentry_key=<klíč>' \
  -H 'Content-Type: application/json' \
  -d '{"message":"test"}'

Data přijímáme na /api/{projekt}/envelope/ i starším /api/{projekt}/store/. Jeden projekt přijme nejvýš 600 eventů za minutu, nad limit odpovíme 429.

JavaScript

terminál

npm i @sentry/browser

javascript

import * as Sentry from "@sentry/browser";
Sentry.init({
  dsn: "https://<klíč>@api.webovahlidka.cz/<projekt>",
  release: "v1.0.0",
  environment: "production",
});

Hodnota release musí odpovídat verzi, ke které nahrajete source mapy. React, Vue i Next.js používají stejné DSN.

PHP

terminál

composer require sentry/sentry

php

\Sentry\init([
    'dsn' => 'https://<klíč>@api.webovahlidka.cz/<projekt>',
    'release' => getenv('APP_VERSION'),
    'environment' => 'production',
]);

Balíčky sentry/sentry-symfony a sentry/sentry-laravel fungují stejně – nastavte jim stejné DSN.

Node

terminál

npm i @sentry/node

javascript

const Sentry = require("@sentry/node");
Sentry.init({
  dsn: "https://<klíč>@api.webovahlidka.cz/<projekt>",
  release: process.env.APP_VERSION,
});

Serverless funkce končí hned po odpovědi – před koncem zavolejte Sentry.flush().

Source mapy

Source mapy přeloží minifikovaný stacktrace na skutečné soubory a řádky. Nahrajete je v detailu projektu na záložce Releasy – soubory .js, .map, .mjs a .cjs do 64 MB. Soubor se stejným názvem nahraný znovu přepíše předchozí.

Releasy

Verzi z pole release uvidíte u každé chyby, spolu s prvním a posledním releasem, ve kterém se objevila. Vyřešená chyba, která se v novém releasu vrátí, dostane značku regrese.

Webhooky

Kanál Webhook pošle při upozornění POST s JSONem:

json

{
  "subject": "eshop-klienta.cz je nedostupný",
  "content": "Byl vytvořen nový incident …"
}

Čekáme nejvýš 10 sekund a nenásledujeme přesměrování. Adresy do vnitřní sítě odmítneme.