Hata iletilerindeki SharePoint Bağıntı Kimliği: Nedir ve nasıl kullanılır?
Uygulandığı Öğe
SharePoint Server 2016 Microsoft 365’te SharePoint

Genel bir web sitesi veya anket, e-posta veya başka bir uygulamayla ilgili sorun yaşayan bir kullanıcıysanız, web sitesinin sahibi olan şirketi arayın ve onlardan yardım isteyin.   Bir web sitesi veya anketin iletişim bilgilerini genellikle sayfanın en altında veya gezinti menülerinin Hakkında veya Bize ulaşın bölümlerinde bulabilirsiniz.

Bir işletmede kullanıcıysanız ve hatalar alıyorsanız, işletmenizin iç web sitesini yöneten kişiye başvurun.   Bu tür sorunlar genellikle yalnızca web uzmanı (SharePoint yöneticisi) veya şirketinizdeki biri tarafından düzeltilebilir.

Bir SharePoint yöneticisi, web uzmanı veya site yöneticisiyseniz   ve kullanıcılarınız bağıntı kimlikleri hakkında sorular soruyorsa, bu makale size yardımcı olabilir.

Bağıntı kimliğinin ne olduğu ve ne olmadığı

Bağıntı kimliği bir hata numarası veya kod değildir. Basitçe, SharePoint sunucusunun aldığı her istek için otomatik olarak oluşturulan bir GUID'dir (genel benzersiz tanımlayıcı). Her hata için değil, her istek için benzersizdir. Öte yandan bir hata oluştuğunda, hata iletisi o sırada istek için geçerli olan bağıntı kimliğini içerir.

Bağıntı kimliğinin, SharePoint Yöneticisinin hata sırasında neler olduğunu izlemesine yardımcı olmak için kullanılması amaçlanmıştır. Yalnızca Yöneticinin hatanızı izlemesine yardımcı olacak etkileşimli bir araç olarak değerlidir. Yönetici bağıntı kimliğini, SharePoint Birleşik Günlük Sistemi'ndeki (ULS) istekleri veya işlemleri geriye doğru izlemek ve soruna neyin yol açtığını bulmak için "içerik haritaları" olarak kullanır. SharePoint bu görev üzerinde çalışırken tanımlayamadığı bir hata alırsa, "Beklenmeyen bir hata oluştu" iletisi gönderir ve bağıntı kimliğini içerir. Bağıntı kimliği, ne olduğunu bulmanıza yardımcı olabilir ancak ne olduğunu belirlemez.

Bağıntı kimliğinin nasıl atandığını gösteren diyagram

Başarılı istekler de başarısız istekler gibi bağıntı kimliğiyle etiketlenir. Kimlik, her yeni istek için benzersiz ve farklıdır, ayrıca yalnızca isteğin süresi boyunca geçerlidir. Bu, size sorunu tam olarak tanımlayan bir 80xxx sayısı veren Windows hataları gibi değildir. Web'de belirli bir bağıntı kimliğini aramanıza yardımcı olmaz çünkü her biri sunucunuz ve zamanın bu noktası için farklı ve benzersizdir.

Bağıntı kimliğinin değerli olduğu yer, bir işlemin izlenmesidir. SharePoint istekleri işlerken yaptığı her şeyin günlüğünü (ULS) oluşturur ve bağıntı kimliği temelde her adımı birbirine bağlayan iş parçacığıdır. SharePoint aynı anda binlerce istek yaptığı için, bağıntı kimliği yalnızca SharePoint tarafından belirli bir isteğe yönelik olarak gerçekleştirilen adımları filtrelemek için kullanılabilir.

Yönetici bağıntı kimliğini kullanarak hataları, performans sorunlarını ve diğer sorunları izleyebilir. Sorunlu davranışı sergileyen istekler için bağıntı kimliklerini kullanarak daha ayrıntılı araştırma yapabilir.  Hata yoksa ve hiçbir hata iletisi oluşturulmazsa, işlemler tarafından oluşturulan bağıntı kimliğini görüntülemek için geliştirici panosu kullanılabilir. 

Son kullanıcıysanız, büyük olasılıkla bağıntı kimliğinin yararlı olabileceği bilgileri sağlayan günlüklere erişemezsiniz. Bu durumda burada durabilir ve yardım masanızı veya Yöneticiyi arayabilirsiniz. Sorununuzu açıklayın ve sorunu tanılamaya yardımcı olmak için onlarla birlikte çalışın. Onlara hata iletinizde gördüğünüz bağıntı kimliğini verin; bu kimlik onlara gerekebilir.

BT Uzmanı veya Yönetici olarak, ne olduğunu anlamak için olayın gerçekleştiği zamana ilişkin ULS günlüklerini bulmanız ve bu günlüklerde Bağıntı Kimliğini aramanız gerekir. Aradığınız bağıntı kimliğini içeren günlüğü bulmak için web ön uçlarının birkaçını incelemeniz gerekebilir. Bağıntı kimliği hatanızı çözmez, ancak neyin yanlış gittiğini görmek için bir isteği izlemenize yardımcı olabilir. Hata oluşmadan hemen önce ne olduğu, hangi hata iletilerinin göründüğü veya bu hata nedeniyle hangi olayların tetiklendiği (varsa) hakkında bazı içgörüler elde edebilirsiniz. Bu verilere bakmayı kolaylaştırmak ve görmeniz gerekmeyen istekleri filtrelemek için ULSViewer gibi bir araç kullanabilirsiniz. Daha fazla fikir ve ipucu için ULSViewer kullanarak SharePoint günlüğü oluşturma ve sorun giderme blog gönderisine bakın.

Bir Yöneticinin bağıntı kimliği kullanırken uygulayabileceği tipik bir senaryo aşağıda verilmiştir:

  • Kullanıcı Excel'de bir dosyayı açarken hata alır ve bu hata Yöneticiye bağıntı kimliğini ve olayın tarihini/saatini verir:

  • Günlük dizinini ve aradığınız tarihi bulun, bu dosyayı Excel'de açın:

  • Aradığınız bağıntı kimliğini bulun. Neler olduğuna ilişkin fikir edinmek için olayların düzeyine göre de filtreleyebilirsiniz:

  • Bağıntı kimliğini bulamazsanız, sorunun bildirildiği sırada dönüşte olan başka bir web sunucusunu deneyin.

SharePoint hatalarını ayıklamaya yardımcı olacak bazı ek Yönetici kaynakları aşağıda bulabilirsiniz. Bu bağlantılara ek olarak, SharePoint ile çalışmaya yönelik destek ve araçlar sunan birçok üçüncü taraf site ve topluluk olduğundan web'de arama yapmayı deneyin. SharePoint bir platform olduğundan binlerce geliştirici, BT Uzmanı ve birbirine yardımcı olacak araçlar, uygulamalar ve belgeler geliştiren kullanıcıdan oluşan bir topluluk söz konusudur.

Daha fazla yardıma mı ihtiyacınız var?

Daha fazla seçenek mi istiyorsunuz?

Abonelik avantajlarını keşfedin, eğitim kurslarına göz atın, cihazınızın güvenliğini nasıl sağlayacağınızı öğrenin ve daha fazlasını yapın.