Skip to main content
Bir sorunun takip edilmesi gerektiğinde destek talebi oluşturun. Ardından bir kişi veya bir AI agent talebi takip edebilir ve istenen bağlamı ekleyebilir. Talebi yalnızca onu oluşturan hesap ve LogBrew destek ekibi okuyabilir.
$LOGBREW_TOKEN gibi bir hesap erişim bearer tokenı kullanın. Bir projenin alım anahtarını (ingest key) asla kullanmayın. Başlığı, açıklamayı veya tanılama bilgisini yazmadan önce özel verileri çıkarın. Otomatik gizleme bu kontrolün yerini tutmaz.

Talep oluşturun

CLI’dan şunu çalıştırın:
CLI, source değerini cli yapar. --diagnostics yalnızca ikili dosya adını, CLI sürümünü, işletim sistemini ve mimariyi ekler. Tüm seçenekler için logbrew support --help komutunu çalıştırın. CLI, talep oluştururken yeniden deneme anahtarı göndermez. Sonuç belirsizse komutu yeniden çalıştırmadan önce logbrew support list --json komutunu çalıştırın. Aksi hâlde ikinci bir talep oluşturabilirsiniz. API’den source, category, title ve description alanlarıyla POST /api/support/tickets isteği gönderin. Yeniden denemeyi güvenli hâle getirmek için rapor başına bir kez yeniden deneme anahtarı oluşturun ve bunu Idempotency-Key başlığında gönderin. Bu örnek yapay değerler kullanır:
Yeniden deneme anahtarı, boşluk içermeyen 1 ile 128 arasında görünür ASCII karakterden oluşur. Yeniden denemek için aynı anahtarı aynı gövdeyle gönderin. Yanıt aynı talebi verir. Farklı bir rapor için yeni bir anahtar kullanın. Zaman aşımı, oluşturmanın başarısız olduğunu kanıtlamaz. Idempotency-Key başlığı isteğe bağlıdır. Bu başlık olmadan tekrarlanan bir istek başka bir talep oluşturabilir. İsteğe bağlı alanlar project_id, environment, runtime, framework, sdk_package, sdk_version, release, trace_id, event_id ve diagnostics alanlarıdır. Sorun belirli bir projeye ait değilse project_id alanını göndermeyin. project_id, hesabınızdaki etkin bir projeyi tanımlamalıdır. Başarılı bir istek HTTP 200 döndürür:
Talep kimlikleri sup_ ile başlar. next alanını bir kişiye yönlendirme olarak, next_action alanını program akışı için kullanın. Bir projeyi silmek için proje ayarlarını veya logbrew projects delete komutunu kullanın. Proje silme işlemini destek talebiyle istemeyin.

Yararlı bir rapor yazın

  • Her talepte tek bir sorun bildirin.
  • En yakın category değerini seçin. other değerini yalnızca hiçbir kategori uymadığında kullanın.
  • title alanında tek bir belirti ve tek bir yüzey belirtin.
  • description alanına önce adımları, ardından beklenen ve gözlemlenen sonucu yazın.
  • Proje, sürüm, iz veya olay kimliklerini yalnızca aynı hatayı tanımlıyorlarsa ekleyin.
Şu diagnostics anahtarlarını kullanın: diagnostics, gizlemeden sonra en fazla 16 KB olan bir JSON nesnesidir. Anahtarı bir kimlik bilgisini, oturumu veya e-posta adresini adlandıran bir değeri LogBrew [redacted] ile değiştirir. Kimlik bilgisine, URL’ye veya yerel yola benzeyen metni de değiştirir. LogBrew ayrıca uzun metinleri kısaltır ve iç içe yapıları, anahtarları ve liste öğelerini sınırlar. Bu gizlemeye güvenmeyin. İsteği göndermeden önce özel verileri çıkarın.

Talebi takip edin

Liste project_id, status, source, category, release ve limit parametrelerini kabul eder. Varsayılan limit 100, en büyük değer 500 olur. Cursor ile sayfalama için pagination=cursor gönderin. Sonraki sayfalarda aynı filtreleri tekrarlayın ve next_cursor içindeki cursor_time ve cursor_id değerlerini gönderin. Cursor kimliği bir sup_ talep kimliğidir. next_cursor değeri null olduğunda durun. CLI --project, --status, --source, --category, --release, --limit, --pagination, --cursor-time ve --cursor-id seçeneklerini kullanır. Durum değerleri open, routed, in_progress, waiting_on_user, resolved ve closed olur. Yalnızca open veya closed ayarlayabilirsiniz. Tekrarlanan bir kapatma veya yeniden açma isteği, hiçbir şeyi değiştirmeyen başarılı bir istektir. Bu yüzden aynı isteği yeniden deneyebilirsiniz. Döndürülen durumu ve next_action alanını izleyin:

İstenen bağlamı ekleyin

Talep bağlam istediğinde yanıt verin. Böyle bir talebin durumu waiting_on_user, next_action.code değeri provide_context olur.
API gövdesi context ve isteğe bağlı diagnostics alanlarını içerir. context metni 1 ile 4.000 arasında karakter içermelidir. context içine kimlik bilgisi, URL, ana bilgisayar adı veya yerel yol yazmayın. API bu metni 422 ile reddeder. Idempotency-Key başlığında bir yeniden deneme anahtarı gönderin. Bağlam rotası bu başlığı zorunlu tutar. Anahtar, boşluk içermeyen 1 ile 128 arasında görünür ASCII karakterden oluşur. Her yanıt için yeni bir anahtar kullanın. Bir anahtarı yalnızca aynı yanıtı yeniden denemek için tekrar kullanın. API, talep open, routed, in_progress veya waiting_on_user durumundayken bağlam kabul eder. Talebin her durumu için 1 yanıt kabul eder. Bir yanıttan sonra daha fazla bağlam göndermeden önce durumun değişmesini bekleyin. waiting_on_user durumundaki bir talebe verilen yanıt, talebi open yapar. Bu değişikliği varsaymak yerine döndürülen status değerini okuyun. Başarılı bir yanıt ticket_id, context_id, status, created_at, next ve next_action döndürür. context_id, ctx_ ile başlar. Sonraki bir isteği yanıtlamadan önce talebi yeniden okuyun. GET /api/support/tickets/{ticket_id}/context, en son 20 bağlam kaydını en eskiden başlayarak döndürür. Her kayıtta context_id, context, diagnostics ve created_at bulunur. Bu listede cursor yoktur. resolved veya closed durumundaki bir talebe verilen yanıt, code: "validation_failed" ile 422 döndürür. Talebi yalnızca kullanıcı o destek isteğine devam etmek istiyorsa yeniden açın. Bir next_action, agent’a hesap durumunu değiştirme izni vermez.

Hatalardan kurtarın

Hata yanıtları error, code, next ve next_action alanlarını içerir. Bkz. API hataları.

Raporu güvenli tutun

Gizli bilgileri, tokenları, yetkilendirme başlıklarını, alım anahtarlarını, ham logları, müşteri verilerini, yerel yolları, ana bilgisayarları veya ilgisiz kaynak kodunu asla göndermeyin. Kısa ve gizlenmiş bir özet gönderin. Kendi başınıza yapabileceğiniz kontroller için Sorun giderme sayfasına bakın.