# Kullanım ve hata panosu

Yayındaki bir uygulamanın kaç kez kullanıldığını, ne kadar hata verdiğini ve yakın zamandaki hata kayıtlarını gösterir.
Uygulamanın sahibi ve o portalın şirket yöneticisi görebilir.

## Ne zaman bakılır

Kullanıcı *"çalışmıyor"*, *"hata veriyor"*, *"yavaşladı"*, *"dün açılmadı"* gibi bir sorun bildirdiğinde **kodu
değiştirmeden önce** panoya bakın:

| Nereden | Nasıl |
|---|---|
| MCP aracı | `one_app_health` (`appSlug`, isteğe bağlı `portalKey`, `days`; varsayılan 7) |
| Komut | `one status [--portal <anahtar>] [--days 7]` (`one login` oturumuyla; `--json` ham yanıtı basar) |

## Ne döner

| Alan | Anlamı |
|---|---|
| Dönem | Özetin kapsadığı günler |
| İstek ve hata | Toplam istek, hata sayısı ve oranı |
| İşlemci süresi | İstek başına ortanca süre ve en yavaş %1'lik dilimin süresi (milisaniye) |
| Günlük | Gün başına istek ve hata |
| Son hatalar | Uygulamanın `logError` ile yazdığı son kayıtlar (zaman, varsa adres yolu, kısaltılmış ileti) |
| Başarısız arka plan işi | Tüm denemeleri tükenen [zamanlanmış görev ya da kuyruk işi](/docs/jobs.md) sayısı |

Panoda kişisel veri ve ileti gövdesi yoktur; hata iletileri kısaltılmıştır. Bu yüzden uygulamanızda `logError`'a
**anlamlı ama kişisel veri taşımayan** iletiler yazın ("Rapor tablosu okunamadı", "Onaylayıcı bulunamadı"); panoda
göreceğiniz tek ipucu odur.

Yanıt *"Kullanım ve hata panosu bu ortamda yapılandırılmamış"* derse veri yoktur; kullanıcıya yalnız bunu söyleyin ve
sorunu kullanıcının anlattıklarıyla ve yerel çalıştırmayla (`one dev`) arayın.

## Kullanıcıya nasıl söylenir

- Hata iletilerini **kullanıcıya teknik dille aktarmayın.** İleti geliştirici içindir; kullanıcıya sorunu ve ne
  yaptığınızı sade dille anlatın: *"Dün öğleden sonra rapor ekranı 12 kez açılamamış; sebebi veritabanındaki eksik bir
  alan. Düzelttim, test ortamına yayınladım, önizleme adresinden deneyebilirsiniz."*
- Sayıları yorumlayın, olduğu gibi yapıştırmayın: *"Son bir haftada 2.000 kez kullanılmış, hataların oranı %1,5."*
- Hata yoksa bunu da söyleyin; sorun uygulamada değilse (izin, kurulum, menü) [erişim talebi](/docs/access-requests.md)
  ya da [başlangıç](/docs/getting-started.md) belgesine dönün.

## Düzeltmeden sonra

Düzeltmeyi [yükleyip yayınlayın](/docs/publishing.md) (`one publish` ya da `one_source_upload`, test ortamına), kullanıcıdan önizlemede denemesini isteyin,
sonra panoya yeniden bakın. Sorun canlıdaysa ve hızlı bir düzeltme yoksa önceki sürüme **geri alma** seçeneğini
kullanıcıya veri kaybı uyarısıyla sunun ve açık onayını alın.