Loglar
Her workflow çalışması kayıt altına alınır — siz başlattığınızda, bir zamanlama tetiklediğinde, bir webhook geldiğinde veya sohbetten başlatıldığında. Logs sekmesi bu çalışmaları geri okuduğunuz yerdir: hangi workflow çalıştı, nasıl bitti, ne kadar sürdü ve bir tık ötesinde — her adımın tam olarak neyi aldığı ve neyi ürettiği.
Bir şey beklediğiniz gibi gitmediğinde açacağınız sayfa burasıdır.
:::info Loglar tüm organizasyonu kapsar Logs sekmesi bir yönetici görünümüdür. Yalnızca sizin oluşturduklarınızı değil, organizasyonunuzdaki her workflow'un çalışmalarını listeler. :::
Logs'u Açma
Workflows → Logs'a gidin.
Sekme üç bölümden oluşur:
- Solda bir filtre satırı, sağda bir Refresh düğmesi.
- Çalışmalar tablosu.
- Birden fazla sayfa çalışma varsa tablonun altında Previous / Next sayfalama.
Çalışmalar tablosu
Her çalışma bir satırdır.
| Sütun | Ne gösterir |
|---|---|
| Workflow | Çalışan workflow |
| Status | Çalışmanın nasıl bittiği veya şu an nerede olduğu |
| Trigger | Çalışmanın nasıl başladığı |
| Started | Başladığı tarih ve saat, yerel saatinizle |
| Duration | Ne kadar sürdüğü |
Tablonun kendiliğinden yaptığı birkaç şey:
- Başarısız ve iptal edilmiş çalışmalar hafif kırmızı bir tonla işaretlenir; böylece listeyi kaydırırken sorunlu çalışmalar öne çıkar.
- Workflow'u silinmiş bir çalışma Workflow sütununda (deleted) gösterir. Çalışma kayıt olarak geçmişte kalır ama açılamaz — tıkladığınızda "This run's workflow was deleted — no execution detail." uyarısını görürsünüz.
- Diğer satırlara tıklayınca çalışmanın tüm detayı açılır.
Çalışma durumları
| Durum | Anlamı |
|---|---|
| Queued | Kabul edildi, başlamayı bekliyor |
| Running | Şu anda sürüyor (rozet nabız gibi atar) |
| Completed | Başarıyla bitti |
| Failed | Bir adım hata aldığı için durdu |
| Cancelled | Bitmeden durduruldu |
| Paused | Devam edebilmek için bir şey bekliyor — örneğin ilgilenilmesi gereken bir bağlantı |
:::tip Duraklatılmış bir çalışma bitmiş bir çalışma değildir Bir bağlantıyı bekleyerek duraklayan çalışma, bağlantıyı düzelttikten sonra sürdürülebilir. Bunu Logs'tan değil, workflow düzenleyicisinden yaparsınız — bkz. Workflow Çalıştırma. :::
Çalışma nasıl başladı
Trigger sütunundaki renkli bir rozet, çalışmanın nereden geldiğini söyler.
| Tetikleyici | Çalışmayı başlatan |
|---|---|
| Manual | Workflow düzenleyicisinde Run'a tıklayan bir kişi |
| Webhook | Workflow'un webhook adresini çağıran dış bir servis |
| Schedule | Sıradaki zamanına gelen yinelenen bir zamanlama |
| Chat | Bir yapay zekâ asistanıyla yapılan sohbet, kullanıcı onayladıktan sonra |
Bu sütun çoğu zaman "bu neden gece 3'te çalıştı?" sorusunun en hızlı cevabıdır — yinelenen çalışmalar için Zamanlamalar, webhook ve sohbet başlangıçları için Workflow Çalıştırma sayfalarına bakın.
Listeyi daraltma
Tablonun üstünde üç açılır liste vardır. Birlikte çalışırlar — istediğiniz kadarını ayarlayabilirsiniz.
| Filtre | Seçenekler |
|---|---|
| All workflows | Organizasyonunuzdaki tek bir workflow |
| All statuses | Completed · Failed · Running · Queued · Paused · Cancelled |
| All triggers | Manual · Webhook · Schedule · Chat |
Herhangi bir filtreyi değiştirmek sizi sonuçların ilk sayfasına döndürür.
Sayfayı yeniden yüklemeden en yeni çalışmaları getirmek için Refresh'e tıklayın. Bu, bir çalışma hâlâ sürerken işe yarar: yenileyin ve Running'in Completed ya da Failed'e dönüşünü izleyin.
:::tip En hızlı eleme All statuses'ü Failed yapın ve diğerlerine dokunmayın. Geriye kalan, en yeniler dahil tüm sorun listenizdir. :::
Çalışmalar arasında sayfalama
Bir sayfaya sığmayacak kadar çok çalışma olduğunda, tablonun altında Previous ve Next belirir; aralarındaki sayaç hangi dilime baktığınızı ve toplamda kaç çalışmanın eşleştiğini gösterir — örneğin 31–60 / 214.
İlk sayfada Previous, sona geldiğinizde ise Next soluklaşır.
Tablo boş olduğunda
Mesaj, tablonun neden boş olduğunu söyler; böylece endişelenmeniz gerekip gerekmediğini bilirsiniz.
| Gördüğünüz | Anlamı | Ne yapmalı |
|---|---|---|
| No runs yet — "Runs appear here once you execute a workflow, attach a schedule, or trigger a webhook." | Henüz hiçbir şey çalışmadı | Bir workflow çalıştırın ya da ona bir zamanlama veya webhook ekleyin |
| No runs match this filter | Çalışmalar var ama kurduğunuz filtrelere uymuyor | Üç açılır listeyi sıfırlamak için Clear filters'a tıklayın |
| Could not load logs. | Liste getirilemedi | Try again'e tıklayın |
Bir çalışmayı inceleme
Bir çalışmaya tıkladığınızda sayfanın üzerinde tam ekran bir inceleyici açılır. Burası o tek çalışmanın adım adım ayrıntılı kaydıdır.
× ile, Esc tuşuyla veya dışarıdaki karartılmış alana tıklayarak kapatabilirsiniz.
Üst çubuk
Soldan sağa:
| Öğe | Ne yapar |
|---|---|
| Workflow adı | Bu çalışmanın ait olduğu workflow |
| Status | Renkli bir nokta ve durum kelimesi |
| Tetikleyici rozeti | Bu çalışmanın nasıl başladığı |
| Çalışma kimliği | Kısa bir kimlik — tıklayınca tamamı kopyalanır; birine tam olarak bu çalışmayı göstermeniz gerektiğinde işe yarar |
| Re-run | Workflow'u baştan yeniden başlatır. Bir bildirim "Workflow re-run started" der |
| ↑ / ↓ | İnceleyiciyi kapatmadan listedeki önceki veya sonraki çalışmaya geçin |
| × | Kapat |
:::caution Re-run ile durdurma aynı şey değildir İnceleyicideki tek çalışma kontrolü Re-run'dır. Hâlâ süren bir çalışmayı durdurmak veya duraklatılmış birini sürdürmek için workflow düzenleyicisindeki durum şeridini kullanın — bkz. Workflow Çalıştırma. :::
Ölçüm şeridi
Üst çubuğun altındaki ince satır çalışmayı bir bakışta özetler:
- Started — başladığı tarih ve saat
- Duration — çalışmanın tamamının süresi
- {n} blocks — kaç adımın kaydedildiği
- Failed at {adım adı} — kırmızıyla, yalnızca çalışma başarısız olduğunda
Bu sonuncusu genellikle daha hiçbir şey okumadan sorunuzu cevaplar.
Zaman çizelgesi
Ölçüm şeridinin altında, çalışmayı bir şelale olarak gösteren tek bir bant vardır. Her adım renkli bir parçadır: konumu adımın ne zaman başladığını, genişliği ne kadar sürdüğünü gösterir.
- Art arda çalışan adımlar soldan sağa bir zincir gibi okunur.
- Aynı anda çalışan adımlar (bir Parallel bloğunun içinde) üst üste biner.
- Başarısız parçalar kırmızıdır ve bir ünlem işareti taşır.
- Bir parçanın üzerine gelince adımın adını ve kaç milisaniye sürdüğünü görürsünüz; tıklayınca aşağıda o adım seçilir.
Çalışmanın zaman bilgisi yoksa bandın yerine "No timing data for this run" yazar.
Adım listesi
Sol bölme, olayların gerçekleştiği sırayla, yukarıdan aşağıya çalışmanın izidir.
Her satırda adımın simgesi, bir durum simgesi, adı ve kısa bir sonuç satırı bulunur:
| Sonuç satırı | Anlamı |
|---|---|
| Success in 142ms | Adım temiz bitti, ne kadar sürdüğüyle birlikte |
| Failed in 1.2s | Adım hata aldı — satır kırmızıdır |
| Running… | Hâlâ sürüyor |
| Pending | Kaydedildi ama henüz başlamadı |
Döngüler ve paralel dallar iç içe görünür: kapsayıcı, yanında bir ok bulunan tek bir satırdır ve yinelemeleri onun altında yer alır. Katlamak veya açmak için kapsayıcıya, sağda incelemek için tek bir adıma tıklayın.
:::tip Başarısız bir çalışma hatanın üzerinde açılır Başarısız olmuş bir çalışmayı açtığınızda ilk başarısız adım sizin için otomatik olarak seçilir — aramanıza gerek kalmadan doğrudan "ne bozuldu" noktasına inersiniz. :::
Hiçbir şey kaydedilmemişse bölmede "No steps recorded for this run." yazar.
İki bölme arasındaki ayırıcıyı sürükleyerek adım listesine daha çok veya daha az yer verebilirsiniz. Dar ekranlarda bölmeler yan yana değil, adım listesi üstte olacak şekilde alt alta dizilir.
Input ve Output
Sağ bölme, seçili adımın Input'unu üstte, Output'unu altta gösterir. Bir adım seçene kadar "Select a node to inspect its input and output" yazar.
- Input, adıma akan her şeydir — alanlarının o an hangi değerlere karşılık geldiği.
- Output, adımın ürettiğidir; sonraki adımların
<agent.content>gibi referanslarla okuduğu şey tam olarak budur.
Değerlerin nasıl gösterildiği, ne olduklarına bağlıdır:
- Yapay zekâ adımlarından gelen metin sonuçları biçimlendirilmiş metin olarak görünür; kullanılan model ve harcanan token için küçük etiketler eşlik eder. Altındaki Structured output bağlantısı aynı sonucu bir veri ağacı olarak açar.
- Diğer her şey açılıp kapanabilen bir ağaç olarak görünür. Üst düzey girdiler açıktır, iç içe olanlar kapalı başlar; böylece büyük bir sonuç bile okunabilir kalır. Her değer küçük bir tür etiketi taşır (string, number, boolean, array, object).
Bir adım birden çok kez çalıştıysa — bir döngü yinelemesi veya paralel bir dal — bölmelerin üstünde bir seçici belirir ve aynı adımın tek tek çalışmaları arasında geçiş yapabilirsiniz.
:::note Sırlar burada asla görünmez
Bir adımın girdisindeki hassas değerler kayıtta gizlenir ve [redacted] olarak görünür. Gizlenmiş bir değer, eksik bir değer demek değildir — adım gerçek değeri almıştır.
:::
Bir adım başarısız olduğunda
Başarısız bir adımı seçtiğinizde, Input'unun üzerinde kırmızı bir hata kartı belirir.
Kart, hata mesajını sade bir dille en başa koyar, ardından hata hakkında bilinenleri ekler:
| Kartın bölümü | Size ne söyler |
|---|---|
| Mesajın altındaki etiketler | Sorunun türü, adım bir servisi çağırıyorduysa bir HTTP durumu, bir hata kodu, aynı çağrıyı tekrar denemeye değdiğinde bir Retryable işareti ve bir yapay zekâ adımının durma nedeni |
| Details from {adım adı} | Adımın türü ve kimliği, durumu, başarısız olmadan önce ne kadar çalıştığı, ne zaman başladığı ve bir döngü içindeyse hangi yinelemenin başarısız olduğu |
| On error | Hatanın Routed to the error branch (workflow'unuz devraldı) mı yoksa Halted the run (orada durdu) mu olduğu |
| Copy as JSON | Hata kaydının tamamını panonuza kopyalar; yardım edebilecek kişiye yapıştırmaya hazır |
Kartın hemen altında hataya yol açan Input yer alır — gerçek cevap neredeyse her zaman oradadır.
:::tip Çalışma sorunlarının çoğu veri sorunudur Adımlar kendi başına nadiren bozulur. Çok daha sık olarak bir referans, orada olmayan bir değeri işaret eder — farklı yazılmış bir alan adı, önceki adımdan gelen boş bir sonuç, beklediğiniz alanı taşımayan bir tetikleyici. Başarısız adımın Input'u ile bir önceki adımın Output'unu karşılaştırın; uyuşmazlık genellikle hemen göze çarpar. :::
Başarısız bir çalışmayı ele almak
Tekrarlanabilir bir yöntem:
- Workflows → Logs'u açın ve durum filtresini Failed yapın.
- Çalışmaya tıklayın. Başarısız olan adımın üzerinde açılır.
- Hata kartını okuyun — mesaj ve etiketleri, bunun bir veri sorunu mu, bir yetki sorunu mu, yoksa dış bir servisin kötü bir günü mü olduğunu söyler.
- O adımın Input'una bakın. Her değer beklediğiniz gibi mi? Boş ya da eksik bir şey var mı?
- Bir değer yanlışsa listede bir adım geri gidip onun Output'unu okuyun — değer oradan geliyor.
- Workflow'u düzeltin (bir referansı, bir alanı, bir bağlantıyı) ve kaydedin.
- Geri dönüp Re-run'a basın ya da düzenleyiciden çalıştırın.
:::caution Hata bir bağlantıdan söz ediyorsa Bir anahtar reddedildiği veya süresi dolduğu için başarısız olan ya da duraklayan bir çalışmada düzeltilmesi gereken workflow değil, bağlantıdır. Bağlantılar sekmesinde halledin, sonra yeniden çalıştırın. :::
İpuçları
- Her değişiklikten sonra Logs'a bakın. Düzenleyiciden bir kez çalıştırmak ve izi bir kez okumak, bir düzenlemenin istediğinizi yaptığını doğrulamanın en hızlı yoludur.
- Çalışma kimliğini kullanın. Bir sorunu bildirirken üst çubuktan kopyalayın — tam olarak tek bir çalışmayı işaret eder.
- Karşılaştırmak için ↑ / ↓ kullanın. Aynı workflow'un biri iyi biri kötü iki çalışmasını yan yana okumak çok hızlı bir teşhistir.
- Yavaş adımlar için zaman çizelgesini izleyin. Tek bir geniş parça, çalışmanızın zamanını harcadığı yerdir.
- Tetikleyiciye göre süzün — bir workflow hem zamanlamayla hem webhook'la çalışıyorsa ve yalnızca biri sorun çıkarıyorsa.
İlgili sayfalar
- Workflow Çalıştırma — çalışmaları başlatma, durdurma, duraklatılmış birini sürdürme
- Zamanlamalar — yinelenen çalışmalar ve birinin neden tetiklenmemiş olabileceği
- Bağlantılar — reddedilmiş veya süresi dolmuş bir bağlantıyı düzeltme
- Bloklar — her adımın ne yaptığı ve ne ürettiği
- Workflow Oluşturma — workflow'un kendisini kurma ve düzenleme
- Workflow'lara Genel Bakış — Workflows sekmelerine bir bakış