Okuma API'si

Okuma yolu yazma yolundan tamamen ayrıdır: ayrı hız sınırı havuzu, ayrı önbellek ve bağımsız ölçeklenebilirlik. Ingest trafiğinin panelinizi yavaşlatmaması bu ayrımın doğrudan sonucudur.

Kimlik doğrulama

Okuma uçları iki kimlik biçimini birden kabul eder:

Biçim Nerede kullanılır
Authorization: Bearer <access-token> Panelde oturum açmış kullanıcı
X-API-KEY: ebrd_pub_… Tarayıcıdan, gömülü bileşenlerden

Publishable anahtar yalnızca izinli alan adı listesindeki origin'lerden kabul edilir. Liste dışından gelen istek 403 alır; anahtarın kendisi sızsa bile başka bir sitede kullanılamaz.

Uçlar

Uç Döndürdüğü
GET /api/v1/projects/{id}/summary Ön hesaplanmış özet (olay sayıları, açık Issue, monitör durumu)
GET /api/v1/projects/{id}/issues Issue listesi (cursor sayfalama)
GET /api/v1/projects/{id}/issues/counts Duruma göre sayaçlar
GET /api/v1/issues/{id} Issue ayrıntısı
GET /api/v1/issues/{id}/events Issue'ya bağlı ham olaylar
GET /api/v1/issues/{id}/breakdown Sürüm/ortam/sunucu dağılımı
GET /api/v1/projects/{id}/events Log arama (tam metin + filtre)
GET /api/v1/projects/{id}/events/histogram Zaman serisi (time_bucket)
GET /api/v1/projects/{id}/usage Kota kullanımı
GET /api/v1/projects/{id}/releases Sürüm başına olay, hata, yeni hata ve regresyon sayısı
GET /api/v1/projects/{id}/releases/details?release= Bir sürümün getirdiği ve geri getirdiği hatalar, önceki sürüm
GET /api/v1/projects/{id}/dashboards Özel dashboard'lar ve grafik tanımları
GET /api/v1/projects/{id}/dashboards/{dashboardId}/widgets/{widgetId}/data Kayıtlı grafiğin verisi
POST /api/v1/projects/{id}/widget-data Kaydedilmemiş bir grafiğin verisi
GET /api/v1/monitors/{id}/uptime Uptime yüzdesi ve günlük döküm
GET /api/v1/monitors/{id}/ssl-status Sertifika durumu ve kalan gün
GET /api/v1/monitors/{id}/domain-status Alan adı bitiş tarihi ve registrar
GET /api/v1/projects/{id}/stream Canlı olay akışı (SSE)
GET /status/{slug} Herkese açık durum sayfası (kimlik gerekmez)

Cursor sayfalama

Liste uçlarında offset yoktur. Sayfalama, son satırın (timestamp, id) çiftinin base64url kodlanmış hâliyle yapılır:

curl "https://api.errorbird.com/api/v1/projects/<id>/issues?limit=50" -H "X-API-KEY: ebrd_pub_…"
# { "items": [...], "nextCursor": "MjAyNi0wOC0xOVQyMTowMDowMFo…" }

curl "https://api.errorbird.com/api/v1/projects/<id>/issues?limit=50&cursor=MjAyNi0w…"

nextCursor null olduğunda liste bitmiştir. Offset'in olmama sebebi performans değil doğruluktur: siz 2. sayfayı okurken yeni bir olay geldiğinde offset tabanlı sayfalama bir kaydı atlar veya iki kez gösterir.

Log arama

GET /api/v1/projects/{id}/events filtreleri birlikte uygular; sonuç yeniden eskiye sıralanır ve cursor ile sayfalanır.

Parametre Anlamı
q Mesajda kelime araması; tırnak, OR ve - desteklenir
level, environment, release Birebir eşleşme
eventHash Aynı imzaya (aynı Issue'ya) ait olaylar
traceId Aynı isteğin logları (CLEF @tr, OTLP traceId); büyük/küçük harf duyarsız
from, to Zaman aralığı (ISO 8601). Verilmezse son 24 saat; traceId ile son 7 gün
cursor, limit Sayfalama; limit en fazla 200
# Bir isteğin tüm logları
curl "https://api.errorbird.com/api/v1/projects/<id>/events?traceId=4bf92f3577b34da6a3ce929d0e0e4736&limit=200" \
  -H "X-API-KEY: ebrd_pub_…"

Her olayda traceId ve spanId alanları döner (gönderilmediyse null). Geçersiz trace kimliği (boşluk içeren, 64 karakteri aşan) 400 invalid_trace_id döner.

Canlı akış (SSE)

const source = new EventSource(
  'https://api.errorbird.com/api/v1/projects/<id>/stream?apiKey=ebrd_pub_…',
)

source.addEventListener('event', (message) => {
  console.log(JSON.parse(message.data))
})

EventSource özel başlık gönderemediği için anahtar sorgu dizesinden alınır. Bu yol yalnızca publishable anahtarları kabul eder — secret anahtar sorgu dizesinde kabul edilseydi, sunucu loglarına ve tarayıcı geçmişine yazma yetkisi olan bir anahtar düşerdi.

Sürümler

/releases "bu deploy neyi bozdu?" sorusunu yanıtlar. Olaylarınızın release alanını taşıması yeterlidir (Serilog/CLEF gövdesinde release, tarayıcı SDK'sında init({ release })); etiketsiz olaylar listeye girmez.

[
  {
    "release": "[email protected]",
    "firstSeen": "2026-10-11T09:02:14Z",
    "lastSeen": "2026-10-11T10:27:40Z",
    "eventCount": 454,
    "errorCount": 194,
    "newIssueCount": 2,
    "regressionCount": 1,
    "sessions": 12840,
    "crashedSessions": 31,
    "crashFreeRate": 99.75,
    "adoption": 64.2
  }
]

Panelin "hata/saat" karşılaştırması bu verilerden hesaplanır: hata olayı sayısı, sürümün ilk ve son olayı arasındaki saate bölünür. Kısa süredir yayında olan bir sürümün ham sayısı, günlerdir yayında olanınkiyle karşılaştırılamaz.

Dashboard'lar

Panelde Dashboard'lar sayfası projenin loglarından, hata gruplarından ve monitörlerinden kendi grafiklerinizi kurmanızı sağlar. Grafik verisi saklanmaz; seçilen aralık (1 saat – 90 gün) için her açılışta hesaplanır. Aynı uçlar publishable anahtarla da okunur: grafikleri kendi panelinizde çizebilirsiniz. Dashboard oluşturmak ve değiştirmek panel oturumu (üye yetkisi) gerektirir; proje başına en fazla 20 dashboard, dashboard başına 24 grafik.

Grafik (kind) Ne gösterir Alanlar
LogVolume Zaman içinde log sayısı; isteğe bağlı kırılım (ilk 5 değer + "diğerleri") query, minLevel, environment, release, groupBy
LogCount Aralıktaki log sayısı ve bir önceki eşit aralık query, minLevel, environment, release
LogTopValues Bir alanın en sık 10 değeri aynı filtreler + zorunlu groupBy
NewIssues Zaman içinde ilk kez görülen hata grubu sayısı minLevel
MonitorResponseTime Başarılı kontrollerin ortalama ve p95 yanıt süresi monitorId
MonitorUptime Başarılı kontrol oranı ve bir önceki aralık monitorId
CrashFreeSessions Çökmeden biten oturumların yüzdesi (saatlik ya da daha geniş kovalar) ve bir önceki aralık release, environment

groupBy: level, environment, release, server, template (mesaj şablonu) ya da meta:Alan — log metadata'sındaki bir özellik, ör. meta:TenantId. query log aramasıyla aynı sözdizimidir.

# Kayıtlı grafiğin verisi (aralık: 15m, 6h, 24h, 7d, 90d…; gün kovaları timeZone'a göre)
curl "https://api.errorbird.com/api/v1/projects/<project-id>/dashboards/<dashboard-id>/widgets/<widget-id>/data?range=7d&timeZone=Europe/Istanbul" \
  -H "X-API-KEY: ebrd_pub_…"

# Kaydetmeden: tanımı gönderin, verisini alın
curl -X POST https://api.errorbird.com/api/v1/projects/<project-id>/widget-data \
  -H "X-API-KEY: ebrd_pub_…" -H "Content-Type: application/json" \
  -d '{ "range": "24h", "widget": { "id": "x", "title": "Kiracıya göre hatalar",
        "kind": "LogTopValues", "minLevel": "Error", "groupBy": "meta:TenantId" } }'
{
  "kind": "LogVolume", "unit": "count", "bucketSeconds": 10800,
  "from": "2026-10-04T12:00:00Z", "to": "2026-10-11T12:00:00Z",
  "series": [ { "name": "Error", "points": [ { "time": "2026-10-04T12:00:00Z", "value": 0 }, … ] },
              { "name": "__other__", "points": [ … ] } ],
  "rows": [], "value": 1810, "previousValue": null
}

Önbellek ve gecikme

/summary, /uptime ve /ssl-status Redis'te önbelleklenir ve arkalarında TimescaleDB sürekli toplamları (continuous aggregate) vardır. Ölçülen değerler: önbellekten p99 18 ms, önbellek boşken p99 189 ms (120.503 olaylı proje).

Önbellek boşken aynı anahtar için gelen eşzamanlı istekler tek bir hesaplamayı paylaşır (single flight); N istek N ayrı sorgu tetiklemez.

Hız sınırı

Okuma havuzu dakikada 600 istektir (anahtar + origin başına). Aşıldığında 429 döner. Bu sayaç yazma havuzundan bağımsızdır.

Herkese açık uçlar (durum sayfası, plan kataloğu, SSO keşfi) IP başına dakikada 120 istekle sınırlıdır.

Çok kiracılı izolasyon

Başka bir organizasyonun/workspace'in kaynağına yapılan istek 403 değil 404 döner. 403, kaynağın var olduğunu doğrular; bu da tek başına bir bilgi sızıntısıdır.