Eğitim: Azure SRE Aracısı'nda bilgi belgelerini yükleme

Bu öğreticide, bilgi belgelerini gelecekteki araştırmalarda başvurabilmesi için Azure SRE Aracınıza yüklersiniz. Araştırma sonuçlarını sohbet aracılığıyla doğrudan Bilgi ayarlarına kaydetmeyi ve mevcut dosyaları portal kullanıcı arabirimi aracılığıyla karşıya yüklemeyi öğreneceksiniz.

Bu eğitimde şunları öğreniyorsunuz:

• Araştırmayı yeniden kullanılabilir bir runbook'a dönüştürün ve Bilgi Ayarları'na kaydedin.
• Karşıya yüklenen içeriğin dizine eklendiğini ve aranabilir olduğunu doğrulayın.
• Portal aracılığıyla tek tek dosyaları veya klasörleri karşıya yükleme
• Aracınızın karşıya yüklenen içeriği yeni bir konuşmada alabildiğini test edin

Tahmini süre: 10 dakika

Önkoşullar

• Running durumunda bir Azure SRE Aracısı
• Aracı üzerinde yazma yetkileri
• Aracı çalıştırma modu Gözden Geçir veya Otonom olarak ayarlandı

1. Adım: Araştırmadan başlama

En iyi bilgi belgeleri gerçek araştırmalardan gelir. Sıfırdan içerik oluşturmak yerine, aracınızın önceden öğrendiklerinden faydalanın.

1. sre.azure.com gidin ve temsilcinizi seçin.
2. Sohbetler altındaki sol kenar çubuğunda önceki bir araştırma yazışmasını (aracınızın bir sorunu tanıladığı veya çözdüğü tüm konuşmalar) bulun ve seçin.

Henüz bir araştırma yazışmanız yoksa yeni bir sohbet başlatın ve temsilcinizden bir şeyi araştırmasını isteyin:

Investigate high memory usage on our container apps

Araştırmanın tamamlanmasını bekleyin ve 2. Adımla devam edin.

2. Adım: Temsilcinizden bir runbook oluşturmasını isteyin

Aynı araştırma yazışmasında, aracınızdan bulguları bir runbook'a dönüştürmesini ve bunu Bilgi ayarlarına kaydetmesini isteyin. Dosya adı hakkında ayrıntılı bilgi alın.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

Temsilciniz:

1. Araştırma bağlamını yapılandırılmış bir süreç rehberine sentezler.
2. Kök Neden Analizi, Tanılama Adımları, Azaltmalar ve Yükseltme Tetikleyicileri gibi bölümler oluşturur.
3. Belgeyi Bilgi ayarlarına kaydeder ve karşıya yüklemeyi onaylar.

Ajan belgenin kaydedildiğini onaylar ve bir indirme bağlantısı sağlar. Runbook'unuz artık Bilgi Ayarları'nda saklanıyor ve arama için endeksleniyor.

Kontrol Noktası

• Araç, araştırmadan yapılandırılmış bir runbook (çalışma kitabı) oluşturdu.
• Aracı, belgenin kaydedildiğini doğruladı.

3. Adım: Bilgi ayarlarında doğrulama

1. Sol kenar çubuğunda Oluşturucu'ya seçerek bölümü genişletin.
2. Bilgi ayarları'nı seçin.

Bilgi ayarları sayfası, belgelerinizi Dosya Adı, Durum, Tür ve Son değiştirme sütunları içeren bir tabloda görüntüler. Durum sütununda belge dizine eklendiğinde ve arama için hazır olduğunda dizine eklendi ifadesi gösterilir.

Durum Bekliyor olarak görünüyorsa Yenile'yi seçin. Dizin oluşturma genellikle birkaç saniye içinde tamamlar.

Kontrol Noktası

• Builder → Bilgi ayarlarına gidildi
• Belge, ✓ Dizine Alındı durumunda görünür.

4. Adım: Portal aracılığıyla dosyaları karşıya yükleme

Tek tek dosyaları veya klasörlerin tamamını doğrudan karşıya yükleyebilirsiniz. Bu yöntem, ekibinizin zaten sahip olduğu runbook'lar, belgeler veya başvuru malzemeleri için kullanışlıdır.

Tek tek dosyaları karşıya yükleme

1. Bilgi kaynakları sayfasında Dosya ekle'yi seçin.
2. Bir dosyayı bırakma bölgesine sürükleyin veya dosyalara göz at'ı seçerek seçin.
3. Dosya ekle'yi seçerek yükleyin.

Klasör yükle

Ayrıca, iç içe alt klasörler de dahil olmak üzere bir klasörün tamamını bırakma bölgesine sürükleyebilirsiniz.

1. Bilgi kaynakları sayfasında Dosya ekle'yi seçin.
2. Bir klasörü dosya yöneticinizden doğrudan bırakma bölgesine sürükleyin.
3. Portal, desteklenen tüm dosyaları klasörden ve alt klasörlerinden ayıklar ve sonra bunları iletişim kutusunda listeler.
4. Dosya listesini gözden geçirin; her dosyanın yanındaki sil simgesini seçerek istemediğiniz dosyaları kaldırın.
5. Listelenen tüm dosyaları karşıya yüklemek için Dosya ekle'yi seçin.

Portal, desteklenmeyen uzantılara sahip dosyaları otomatik olarak filtreler. Desteklenen uzantıların ve boyut sınırlarının tam listesi için Bilgi Belgelerini Karşıya Yükleme özelliği sayfasına bakın.

Dosya boyutu üst sınırı dosya başına 16 MB'tır ve karşıya yükleme başına en fazla 100 MB'tır.

Uyarı

Bir klasörü karşıya yüklediğinizde, portal klasör yapısını korumaz; alt klasörlerdeki dosyalar tek tek belgeler olarak görünür. Farklı alt klasörlerdeki dosyalar aynı adı paylaşıyorsa, yalnızca ilk dosya karşıya yüklenir.

Kontrol Noktası

• Dosya ekle'yi seçtikten sonra karşıya yükleme iletişim kutusunu gördü.
• Dosya başarıyla yüklendi veya klasör başarıyla sürüklendi.
• Dosyalar, Bilgi kaynaklarında✓ Dizine Alındı durumunda görünür.

5. Adım: Yeni bir konuşmada veri alma testi

Yeni bir sohbet yazışması başlatın ve karşıya yüklenen belgelerinizin yanıtlaması gereken bir soru sorun:

What are the steps for troubleshooting high memory usage on container apps?

Ajanınız Bilgi ayarlarını arar, karşıya yüklenen runbook'unuzu bulur ve yanıtta buna atıfta bulunur. Bu süreç, bilginin dizine alındığını ve erişilebilir olduğunu doğrular.

Kontrol Noktası

• Yeni bir sohbet yazışması başlatıldı
• Karşıya yüklenen içerikle ilgili bir soru sorulur
• Yüklenen belgeye ajan yanıtında başvurdu.

Bilgi belgesini silme

1. Oluşturucu → Bilgi ayarları'na gidin.
2. Belgeler listesinde, onay kutularını kullanarak bir veya daha fazla belge seçin.
3. Araç çubuğunda Sil'i seçin.
4. Onay iletişim kutusunda kaldırılacak belgeler listelenir. Onaylamak için Sil'i seçin.

Belgeleri sildiğinizde, aracının Bilgi ayarlarından kaldırırsınız ve bunlar artık arama sonuçlarında görünmez.

Uyarı

Bilgi belgelerini yerinde düzenleyemezsiniz. Belgeyi güncelleştirmek için aynı dosya adına sahip yeni bir sürümü karşıya yükleyin. Yeni sürüm, önceki sürümün yerini alır.

Öğrendikleriniz

• Ajanınız gerçek araştırmaları yapılandırılmış runbook'lara dönüştürebilir ve Bilgi Ayarları'na kaydedebilir.
• Dosyaları Builder → Bilgi ayarlarındaki portal kullanıcı arabirimi aracılığıyla el ile yükleyebilirsiniz. PDF, Office belgeleri ve resimler gibi birçok biçimi destekler.
• Sistem, karşıya yüklenen belgeleri anlamsal arama için dizine alır ve gelecekteki tüm konuşmalarda kullanılabilir.
• Belgeleri güncellemek için aynı dosya adını kullanarak yükleyin.

Sorun giderme

Error	Nedeni	Düzelt
"Aracı belleği devre dışı bırakıldı. Belgeler yüklenemiyor.	Bilgi ayarları aracınızda etkin değil	Bilgi ayarlarını etkinleştirmek için yöneticinize başvurun
"Bilgi ayarlarınıza yazma erişimim yok"	Yetkili karşıya yükleme aracını bulamadı	İsteğinizi yeniden ifade edin: "Bilgi ayarlarına filename.md olarak kaydedin"
"Geçersiz dosya uzantısı. Yalnızca .md ve .txt dosyalarına izin verilir."	Dosya adı .md veya .txt ile bitmiyor (sohbet karşıya yükleme)	.md Aracıdan kaydetmesini isterken veya .txt uzantısı kullanın
"Belge içeriği en fazla 16 MB boyutu aşıyor"	İçerik tek bir belge için çok büyük	Birden çok daha küçük belgeye bölme
"Dosya adı boş olamaz"	Dosya adı sağlanmadı	komut isteminize bir dosya adı ekleyin (örn. runbook.md)

Related

Kaynak	Öğrendikleriniz
Bilgi belgelerini karşıya yükleme	Bunun nasıl çalıştığı ve neden önemli olduğu
Beceri Oluşturma	Bilgi belgelerini tamamlayan yordam becerileri oluşturma
Beceri	Beceriler ve bilgiler birlikte nasıl çalışır?
ADO wiki Bilgisi	Canlı wiki içeriğini bilgi kaynağı olarak bağlama