This page is also available in English. Read in English →
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
}
]
- Pencere:
days(varsayılan 30, en fazla 90). Sayılar vefirstSeenpencere içindir. Liste ilk görülmeye göre yeniden eskiye sıralanır, en fazla 50 sürüm. - Yeni hata: ilk kez bu sürümde görülen Issue. Regresyon: çözülmüş işaretlenmişken bu sürümden gelen bir olayla yeniden açılan Issue. İkisi de yalnızca Error ve Fatal seviyesini sayar; Errorbird bilgi loglarını da gruplar ama "Sipariş alındı" bir sürümün getirdiği hata değildir.
- Oturumlar:
sessions,crashedSessions,crashFreeRate(çökmeden biten oturumların yüzdesi, iki basamağa aşağı yuvarlanır) veadoption(son 24 saatteki oturumların yüzde kaçı bu sürümde) SDK oturum sinyali gönderiyorsa dolar; yoksa oranlarnulldöner ("veri yok", "%100" değil). Hiç log üretmeyen ama oturumu olan sürüm de listede görünür. Bkz. Oturumlar ve crash-free oranı. - Döküm:
/releases/details?release=yeni hataları, regresyonları, bu sürümde en çok olay üreten hataları ve bir önceki sürümün özetini döner. Sürüm adı sorguda gider;web/1.4.0gibi eğik çizgili adlar da geçerlidir. Pencerede o sürümden olay yoksa404 release_not_found. - Gecikme: sayılar sürekli toplamdan okunur ve son olaylar anında görünür. Geçmiş bir zaman damgasıyla geç gelen olaylar (ör. tamponlanmış mobil hatalar) en geç 15 dakika içinde sayılara yansır; zaman damgası 3 günden eski olanlar sürüm sayılarına girmez (Issue ve log aramasında yine görünürler).
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
}
- Kova: aralık en fazla ~120 kovaya bölünür (24 saatte 15 dakika, 7 günde 3 saat,
90 günde 1 gün). Boş kovalar sayımlarda 0, yanıt süresinde
nullgelir. - Hız: kova bir saat ya da daha genişse ve filtre yalnızca seviyeyse grafik saatlik
sürekli toplamdan okunur; 90 gün bile ham tabloyu taramaz. Metin, ortam, sürüm
filtresi ya da seviye dışı kırılım ham tabloya iner ve en fazla 31 gün sorgulanır
(sayı grafiğinde karşılaştırma aralığı dahil); fazlası
400 range_too_long_for_filters. Tek sorgu 10 saniyeyi aşarsa400 query_timeout. - Seri adları: kırılım değeri;
__other__ilk beş dışındakilerin toplamı,""değeri olmayan loglar. Kırılımsız grafiktecount, yanıt süresindeavgvep95. - Uç listesi:
GET/POST /projects/{id}/dashboards,GET/PUT/DELETE /projects/{id}/dashboards/{dashboardId}(PUT grafik listesinin tamamını, sırasıyla yazar),GET …/widgets/{widgetId}/data,POST /projects/{id}/widget-data.
Ö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.