Dayanıklı bir aracıda sorun giderme

Deneysel. Kablo protokolü, SDK ve bu sayfa sonraki bir alt sürümde değişebilir ya da özellik kaldırılabilir. Kalıp kalmayacağını neyin belirlediği Dayanıklı aracılar içinde açıklanmaktadır.

Görünmeyen, Unreachable durumunda kalan veya dokunmaya yanıt vermeyen bir durable agent: üç komut nedeni bulur; bir nedenler tablosu ile durumlar listesi ise çözümü sunar. Sorun giderme, Collie'yi bir bütün olarak ele alır.

İlk kontroller

Bu üçünü sırasıyla çalıştırın:

collie durable list
collie doctor
collie logs

Telefonda daha az bilgi yer alır. Bir durable agent satırında Starting veya Unreachable yazar ve neden belirtilmez. Kablo protokolü sürüm reddinin kendine ait bir ifadesi (Version mismatch) ve durable agent'ın ana sayfasında bir uyarı kutusu bulunur. Reddedilen bir belirtecin bağlantı çubuğunda kendine ait ifadeleri vardır. Diğer tüm nedenleri collie doctor ve collie logs belirtir.

Nedenler tablosu

Collie kalıcı bir aracıya erişemediğinde, Collie'nin geri kalanı yine de başlar ve kalıcı aracı tek bir nedenle erişilemez olarak gösterilir.

Kalıcı aracı bir sources.json girdisi olduğunda bile bir neden ortam değişkenini belirtir. COLLIE_DURABLE_SOCKET değerini girdinin socket alanı, COLLIE_DURABLE_URL değerini url alanı ve COLLIE_DURABLE_TOKEN değerini token alanı olarak okuyun. Bir girdinin çözümü sources.json içindedir. Yalnızca kalıcı olan biçimin çözümü .env içindedir, ardından collie restart gelir.

Ayar bir kuralı ihlal ediyor

Collie bunları kalıcı aracıya çağrı yapmadan bildirir. sources.json girdilerinde bulunan kurallar, köprünün başlangıcında da reddedilir (sources.json dosyasında bir yazım hatası).

Kalıcı aracı yanıt vermiyor veya yanlış yanıt veriyor

Durable agent'lar için doctor satırları

collie doctor, köprünün sorduğu soruların aynısını köprünün sorduğu sırayla her durable agent'a sorar. hello haricinde hiçbir şey göndermez.

sources.json girdilerinin her biri, desk adlı durable agent için durable-socket:desk olarak yazılan altı satırlık bir blok alır. Bloklardan önceki bir sources satırı dosyayı denetler ve bunları bir durable-lead satırı takip eder. Yalnızca durable çalışan bir Collie aynı altı satırı sonek olmadan yazdırır ve mux satırında durable, see the durable-* lines yazar.

Başarısız olan bir satır, kendisinden sonraki satırları durdurur. Collie, gizlilik denetiminden geçemeyen bir soket üzerinden veya kuralını ihlal eden bir token ile durable agent'a asla istek göndermediği için bu satırlar fix the row above first nedeni ile atlandı olarak yazdırılır. Atlanan bir satır hata değildir.

Durumlar

Her durum ne gördüğünüzü, nedenini ve çözümünü belirtir.

sources.json dosyasında bir yazım hatası

Yalnızca tek bir durable agent değil, Collie'nin çöktüğünü görürsünüz: telefon bağlanamaz. collie logs, dosyanın yolu, girdi ve alan bilgisi olan [bridge] FATAL: ile biter.

Bridge, başlangıçta sources.json dosyasını okur ve bilmediği bir alanda, durable olmayan bir kind değerinde, kuralı ihlal eden bir isimde, iki kez kullanılan bir isimde, birlikte bulunan socket ve url alanlarında, ikisi de olmadığında, token içermeyen bir url alanında veya socket içeren bir token alanında durur. Dosyayı düzeltin, ardından collie restart komutunu çalıştırın. collie doctor, sources satırında aynı iletiyi gösterir.

Bridge girdiyi adlandıramadığında (bir nesne değilse, bilinmeyen bir alan içeriyorsa veya isim kuralı ihlal ediyorsa), 0'dan saymaya başlar ve ikincisi için entry 1 yazar. collie durable attach ise 1'den saymaya başlar ve aynı girdi için entry 2 yazar. Her ikisi de hangi alan olduğunu belirtir. İsim geçerli olduğunda bridge ismi yazar: entry "desk".

attach ve detach, okuyamadıkları bir dosyayı yazmayı reddeder; böylece bir yazım hatası diğer girdilerinize asla zarar vermez. 1 çıkış kodu ile dururlar.

Attach işleminden sonra durable agent görünmüyor

Telefonda hiçbir durable agent görmezsiniz ve collie durable list, not loaded (restart to apply) der.

attach ve detach yalnızca sources.json yazar. Bridge bunu başlangıçta okur. collie restart komutunu çalıştırın veya bir dahaki sefere eyleme --restart ekleyin. not loaded yeniden başlatmanın ardından devam ederse collie logs içeriğini okuyun: list, bridge'den gelen bir HTTP 400 yanıtını 404 ile aynı şekilde ifade eder.

Gizlilik denetimi başarısız oluyor

socket-not-private: the socket's folder /tmp/hello has mode 0755, not 0700 görürsünüz ve durable-socket doctor satırı kırmızıdır.

Collie, bir soketi yalnızca tüm yol gizli olduğunda arar. Yaygın nedenler 0755 moduna sahip bir dizin, doğrudan /tmp içinde veya başka bir paylaşılan dizinde bulunan bir soket ve yoldaki bir sembolik bağdır. Sembolik bağları gözden kaçırmak kolaydır: birçok Linux ana bilgisayarında /var/run, /run hedefine bağlanır; bu nedenle /var/run/ ile başlayan bir yol /var/run is a symlink ile başarısız olur. Gerçek yolu kullanın.

Soketin kendi dizininde chmod 700 çalıştırın veya soketi $XDG_RUNTIME_DIR altına taşıyın. Kurallar Dayanıklı bir aracının güvenliği içindedir. SDK ile oluşturulan bir durable agent, modu 0700 olmayan mevcut bir dizinde başlamayı reddeder ve bunu kendisi bildirir.

Eski bir soket dosyası

Bir sokette connection refused görürsünüz ve dosya oradadır.

Kilitlenen bir durable agent, arkasında soket dosyasını bırakır ve bu dosyayı hiçbir şey dinlemez. Durable agent'ı tekrar başlatın. SDK, dinlemeye başlamadan önce ölü bir soket dosyasını kaldırır ve soket canlı olduğunda another instance is already listening ile durur. Dosyayı yalnızca durable agent'ınız temizlemediğinde el ile silin.

Aynı zamanda bir terminal oturumu olan bir isim

Bridge'in başlangıçta the name is the terminal session's own; pick another ile durduğunu veya telefonda bir terminal oturumunun eksik olduğunu görürsünüz.

Bir durable agent, Collie'nin çalıştığı terminalin adını alamaz. Bu isim çoğu kurulumda default değerindedir ve yalnızca durable agent çalıştıran bir Collie üzerinde default kendi durable agent'ının adıdır. Bridge başlangıçta durur ve girdiyi adlandırır. Bir durable agent adını taşıyan bir Herdr oturumu başka bir durumdur: durable agent adı korur, telefon bu oturumu göstermez ve günlük bunu bir kez bildirir. Bunlardan birini yeniden adlandırın.

Kalıcı bir durable-ready uyarısı

collie doctor aracının her çalıştırılmasında bir uyarı olarak durable-ready görürsünüz.

Durable agent hello yanıtı verir ve ready: false der. Telefon bunu Starting olarak gösterir. Bir durable agent, yalnızca konuşmalarını düzenledikten ve açık sorularını yeniden ilettikten sonra hazır olduğunu bildirir. Neyin beklendiğini öğrenmek için durable agent'ın kendi günlüğünü okuyun.

Durable agent alt süreç denetiminde başlangıçta duruyor

Durable agent'ın başlangıçta the descendant check needs Bun on Linux to read the peer of a socket; pass callerCheck: "off" to run without it ile durduğunu görürsünüz.

Denetim Linux üzerinde Bun gerektirir. macOS üzerinde durable agent'ı Node ile çalıştırın veya openCollie komutuna callerCheck: "off" bayrağını geçirin ve önce denetimin neyi koruduğu bölümünü okuyun. Hata durable agent kaynaklıdır. Collie dahil değildir.

Yeniden başlatma sonrasında bir soru geri geliyor

Kalıcı ajan yeniden başlatıldıktan sonra bir soruyu tekrar görürsünüz ya da sorunun zaten yanıtlandığını belirten bir kart görürsünüz.

Yeniden başlatma öncesinden kalan bir soruya verilen yanıt too-late alır; kart bunu belirtir ve kaybolur. Sorunun kimliğini araç çağrısından türeten bir kalıcı ajan aynı soruyu tekrar sorar; böylece yeniden başlatma sırasında gönderilen bir yanıt yerine ulaşır ve araç bir kez çalışır. Her seferinde yeni bir kimlik oluşturan kalıcı ajan ise aynı araç çağrısı için yeni bir soru sorar. Kart bunu gösterir ve Collie ikinci bir push bildirimi göndermez, çünkü push denetimi araç çağrısını anahtar olarak kullanır. Denetim ayrıca konuşma başına dakikada 3, ana bilgisayar başına dakikada 10 ve ana bilgisayar başına saatte 30 push bildirimine izin verir. Bir saat içindeki 31. push olacak bildirim, o ana bilgisayar için tek bir özet push bildirimine dönüşür ve ana bilgisayar bundan sonraki bir saat boyunca başka bildirim göndermez. Kart her zaman gösterilir.

403 caller-refused

Telefonda yanıtın veya iletinin reddedildiğini görürsünüz ve kalıcı ajanın gerekçesi 403 caller-refused şeklindedir.

Kalıcı ajanın alt süreç denetimi çağıranı reddetti. Bu denetim kalıcı ajanın kendisini, kalıcı ajanın başlattığı herhangi bir süreci ve bunlardan ayırt edemediği bir çağıranı reddeder. Kalıcı ajan veya onun çalıştırdığı bir araç Collie sürecini başlattığında ve bu süreç hâlâ onun alt süreci olduğunda Collie, kalıcı ajan tarafında kalır. Collie uygulamasını kalıcı ajanın dışından başlatın, ardından tekrar deneyin.

Tekrar deneyin ve uygulanmış olabilecek bir yanıt

"Yanıtın ulaşıp ulaşmadığından emin değiliz" uyarısı ile Tekrar dene düğmesini ve dokunduktan sonra "Zaten uygulanmış olabilir. Sohbeti kontrol edin." ifadesini görürsünüz.

Yanıt gönderildikten sonra gerçekleşen bir zaman aşımı, kopan bir bağlantı veya bir 5xx hatası, yanıtın ulaşmış olabileceği anlamına gelir. Tekrar dene seçeneği aynı istek kimliğini gönderir; bu nedenle kalıcı ajan replayed yanıtı verir ve soruyu hiçbir zaman iki kez çözümlemez. Soru zaten kapatılmışsa ilk deneme kapatmış olabilir; bu yüzden telefon sohbeti kontrol etmenizi söyler. Bir gönderme, bir durdurma ve bir düğmeye dokunma işlemi kendi ifadeleriyle aynı durumu belirtir.

Durable agent belirteci reddetti

Bağlantı çubuğunda "Kalıcı ajan belirteci reddetti. Bu eşteki COLLIE_DURABLE_TOKEN değerini kontrol edin." iletisini görürsünüz ve gerekçe token-refused olur.

Kalıcı ajan belirteç için 401 veya 403 yanıtı verdi. En yaygın neden, taraflardan birinin önce değiştiği bir rotasyondur. Telefondaki metin, sources.json girdisi için bile COLLIE_DURABLE_TOKEN adını verir: bunu girdinin token değeri olarak okuyun. Collie uygulamasını yeniden başlatmadan önce kalıcı ajana yeni belirteci verin. Belirteçler bölümünde rotasyon adımları yer alır. 403 hatası kalıcı ajanın önündeki bir erişim vekil sunucusundan da kaynaklanabilir.

İki okuma süren Unreachable durumuna geçiş

Bir kalıcı ajanın tek bir başarısız okuma boyunca Ready durumunda kaldığını, ardından Unreachable durumuna geçtiğini görürsünüz.

Başarılı bir okumadan sonraki tek bir başarısız okuma, söz konusu yoklama için son düzeni korur. Art arda gelen ikinci hata kalıcı ajanın durumunu değiştirir. Reddedilen bir belirteç de aynı kuralı izler. Gizlilik denetiminden geçemeyen bir soket yolu tek istisnadır: anında gösterilir.

https üzerinden, çalışmayan veya belirteci reddeden bir kalıcı ajana en fazla 10 saniyede bir sorgu gönderilir; çünkü her deneme faturalandırılan bir istektir. Soket üzerinden ise çalışmayan bir kalıcı ajanın iki okuması arasındaki en küçük aralık 250 ms olur.

Bir crew içinde

Crew üyesindeki bir kalıcı ajan lead telefonda görünür; bu nedenle lead'in bir kalıcı ajanın ne olduğunu bilmesi gerekir.

1.21.0 sürümünden eski bir lead, kalıcı ajanın konuşmalarını soru kartı olmadan listeler ve Terminal sekmesi terminali olmayan bir konuşmayı yoklar. Üye üzerindeki hiçbir şey bunu düzeltmez. Üye bunu kendisi belirtir: collie doctor, durable-lead içinde uyarı verir ve günlük, duyduğu her sürüm için bir kez [durable] the lead is 1.20.1; it shows durable panes without the question card and its Terminal tab polls; update the lead satırını alır. Lead'i güncelleyin.

Lead'den daha eski bir üye tam tersi bir hataya sahiptir. Telefon "Bu makine daha eski bir Collie çalıştırıyor ve yanıtları buradan alamaz. Makineyi güncelleyin veya kalıcı ajan içinde yanıtlayın." uyarısını verir. O üyeyi güncelleyin.