Sorun giderme ve tanılama

Cihaz kendi durumunu tarif edebilir: hangi hipervizör üzerinde çalıştığını, ne kadar bellek kaldığını, hangi kapsayıcıların sonlandırıldığını, sertifikanın dolmak üzere olup olmadığını, dışarıdaki bir sağlayıcıya erişilip erişilemediğini. Sorun giderme, komut çalıştırıp çıktı yorumlayarak değil, bu tarifi okuyarak başlar.

Bu kılavuzun çözdüğü sorun

"docker ps çalıştırın, şimdi kayıtları gösterin, şimdi de 443 dinleniyor mu bakın" diye başlayan bir destek görüşmesi ilk kırk dakikasını olgu toplamakla geçirir. Bu olguların hepsi zaten tanılama anlık görüntüsünün içindedir; yaklaşık üç saniyede toplanır ve hem bu belgelerin hem de ürün içi yardım asistanının okuduğu bir biçimde durur.

Sorun giderme adımları

1. Tanılama anlık görüntüsünü toplayın. Yönetici olarak GET /admin/diagnostics/snapshot çağrısını yapın; ürün içi yardım paneli de aynı belgeyi okur. Yanıt bir findings listesiyle biter: cihazın kendi durumu üzerinde değerlendirdiği kurallar. Her bulgu, neyin somut olarak yanlış olduğunu tek cümleyle söyler ve düzelten çalışma kitabını adıyla verir.
2. Hiçbir şeyi değiştirmeden önce destek paketini toplayın. Destek paketi; anlık görüntüye ek olarak gizli değerleri gizlenmiş etkin yapılandırmayı ve ana makine ajanının kendi durum belgelerini içerir. Böylece bir başkası, üç deneme sonrasında geride bıraktığınız durumu değil gerçekten içinde bulunduğunuz durumu tanılayabilir.
3. Önce en yüksek önem derecesine sahip bulguyu ele alın. Critical, ürünün hizmet vermediği ya da vermeyi bırakmak üzere olduğu anlamına gelir; warning, şu an çalıştığı ama çalışmaya devam etmeyeceği ya da bir denetimin sandığınız işi yapmadığı anlamına gelir; info ise bilinmeye değer olduğunu ve bugün bir işlem gerektirmediğini söyler. Tek bir kritik bulgu çoğu zaman birkaç uyarıyı birden açıklar — belleği tükenmiş bir ana makine bir kök neden ve dört belirti üretir.
4. Bulgunun adını verdiği çalışma kitabını açın. Her bulgu bir çalışma kitabı kimliği taşır ve her çalışma kitabı rehberli çalışma kitapları sayfasında listelenir. Çalışma kitabı belirtiyi sizin kullanacağınız kelimelerle ifade eder, cihazın kendi durumunu sırayla denetler ve hem nedeni hem çözümü söyler.
5. Çalışma kitabının doğrulama adımını çalıştırın, sonra anlık görüntüyü yeniden toplayın. Bulguyu ortadan kaldıran bir düzeltme tamamlanmıştır. Bulguyu yerinde bırakan bir düzeltme, aranan düzeltme değildi.

Hiç bulgu yoksa

Bir kural bir değer üzerinde tetiklenir, değerin yokluğu üzerinde değil. Ana makine ajanı bulunmayan bir kurulum, üzerinde işlem yapamayacağı dört kritik bulgu yerine hiç ana makine bulgusu bildirmez. Dolayısıyla boş bir bulgu listesi ya hiçbir şeyin bozuk olmadığı ya da bozuk olan şeyin ölçülemediği anlamına gelir. Cihazın sağlıklı olduğu sonucuna varmadan önce tanılama anlık görüntüsü referansını okuyup kendi kurulumunuzda hangi bölümlerin dolduğunu görün.

Hiçbir kural tetiklenmediği hâlde ürün hâlâ beklendiği gibi davranmıyorsa belirtiden başlayın:

Çalışma kitapları nasıl çalışır

Bir çalışma kitabı düz metin değil, makine tarafından okunabilir bir dosyadır. Yazacağınız kelimelerle belirtileri, doğru yerde olduğunuzu ortaya koyan ön koşulları, sıralı bir denetim kümesini ve başarısız olan her denetim için nedeni, çözümü ve doğrulamayı listeler.

Aynı çalışma kitabı bu sayede üç biçimde işe yarar: burada okuduğunuz bir kontrol listesi olarak, cihazın kendi belge kopyasında etkileşimli bir kontrol listesi olarak ve ürün içi yardım asistanının sizin yerinize yürüttüğü bir akış olarak — yapabildiği denetimleri kendisi çalıştırır, yalnızca hiçbir aracın göremeyeceğini size sorar. Yapılandırılmış bir model olmadan ve internet bağlantısı olmadan da çalışır.

Sınırlar ve bilinen boşluklar

• Anlık görüntü ana makineyi kendi başına göremez. Ağ geçidi kapsayıcısının Docker soketine erişimi ve makineye görüşü yoktur: kapsayıcının içindeki /proc/meminfo ana makineninkiyle ancak tesadüfen aynıdır ve gördüğü diskler kendi katman dosya sistemidir. Ana makine ve kapsayıcı bölümleri, ağ geçidinin okuduğu iki dosyayı yazan küçük bir ajandan gelir. Bu ajanın hiç çalışmadığı yerlerde her iki bölüm yanlış değil, yoktur.
• Ana makine verileri beş dakikaya kadar eski olabilir ve otuz dakikayı geçtiğinde tamamen atılır. Bu sabah doğru olan boş bellek değerini bildirmek, hiçbir şey bildirmemekten kötüdür.
• Bulgular kurallardır, teşhis değil. Ölçülebilir biçimde neyin yanlış olduğunu söylerler. Her kural geçtiği hâlde tuhaf davranan bir ürün için çalışma kitapları ve destek paketi gerekir.
• Kurulum anındaki hatalar bunların hiçbiri var olmadan önce yaşanır. Ürün çalışmaya başlayana kadar hiçbir şey toplanmaz; bu nedenle sağlama sırasında yaşanan hatalarda kanıt, kurulum programının kendi konsol iletileri ve /var/log/cid-firstboot.log dosyasıdır.

İlgili sayfalar

• Tanılama anlık görüntüsü — her anahtar, onu neyin doldurduğu ve desteğe nasıl paket gönderileceği.
• Sağlık tablosu — her servis, o servis kapalıyken nelerin bozulduğu ve hangi bulgunun tetiklendiği.
• Rehberli çalışma kitapları — yaşam döngüsü aşamasına göre gruplanmış tam katalog.