.NET için istemci kitaplığıyla istemci tarafı günlüğe kaydetme

.NET için Azure Depolama istemci kitaplığı (sürüm 2.1 ve üzeri) ile standart .NET tanılama altyapısını kullanarak .NET istemci uygulamanızın içinden Azure Depolama isteklerini günlüğe kaydedebilirsiniz. Bu şekilde, istemcinizin Azure Depolama hizmetlerine gönderdiği isteklerin ayrıntılarını ve aldığı yanıtları görebilirsiniz.

Azure Depolama istemci kitaplığı, hangi depolama isteklerini günlüğe kaydedebileceğinizi denetlemenizi sağlar ve .NET tanılama altyapısı da günlük verileri üzerinde tam denetim sağlar( örneğin, bunları nereye göndereceğiniz). Örneğin, günlük verilerini işlenmek üzere bir dosyaya veya uygulamaya göndermeyi seçebilirsiniz. Azure Depolama Analizi ve ağ izleme ile birlikte, uygulamanızın Azure Depolama hizmetleriyle nasıl etkileşime geçtiğini ayrıntılı bir şekilde görüntülemek için istemci kitaplığı günlüğünü kullanabilirsiniz. Daha fazla bilgi için bkz. Azure Depolama'yı izleme, tanılama ve sorunlarını giderme.

İstemci kitaplığı günlüğünü etkinleştirme

Aşağıdaki örnekte, depolama günlüğü iletilerini bir metin dosyasında toplamak ve kalıcı hale getirmek için gereken system.diagnostics yapılandırması gösterilmektedir. Yapılandırma bölümü app.config veya web.config dosyalarına eklenebilir.

<system.diagnostics>  
     <!--In a dev/test environment you can set autoflush to true in order to autoflush to the log file. -->  
  <trace autoflush="false">  
    <listeners>  
      ...
      <add name="storageListener" />  
    </listeners>  
  </trace>  
  <sources>  
    <source name="Microsoft.Azure.Storage">  
      <listeners>  
        <add name="storageListener"/>  
      </listeners>  
    </source>  
  </sources>  
  <switches>  
    <add name="Microsoft.Azure.Storage" value="Verbose" />  
  </switches>  
  <sharedListeners>  
    <add name="storageListener"  
      type="System.Diagnostics.TextWriterTraceListener"  
      initializeData="C:\logs\WebRole.log"
      traceOutputOptions="DateTime" />  
  </sharedListeners>  
</system.diagnostics>  
  

Bu örnekte, istemci kitaplığı fiziksel dosyasına C:\logs\WebRole.loggünlük iletileri yazacak şekilde yapılandırılır. Windows olay günlüğüne yazmak için EventLogTraceListener veya ETW alt sistemine izleme verileri yazmak için EventProviderTraceListener gibi diğer izleme dinleyicilerini de kullanabilirsiniz.

Ayrıca, günlük girdilerini arabelleğe almak yerine hemen dosyaya yazmak için autoflush değerini true olarak ayarlayabilirsiniz. Bu ayar, düşük hacimli izleme iletilerine sahip bir geliştirme/test ortamında yararlı olabilir, ancak üretim ortamında autoflush değerini false olarak ayarlamak isteyebilirsiniz. İstemcideki tüm depolama işlemleri için istemci izlemeyi etkinleştirmek (ve tüm iletiler için Ayrıntılı gibi bir düzey belirtmek) için yapılandırma ayarlarını kullanırsınız.

Varsayılan olarak, istemci kitaplığı tüm depolama işlemlerinin ayrıntılarını yapılandırma dosyasında belirttiğiniz ayrıntı düzeyinde günlüğe kaydeder. Günlüğe kaydedilen veri miktarını azaltmak ve ihtiyacınız olan bilgileri bulmanıza yardımcı olmak için günlük kaydını istemci uygulamanızın belirli alanlarıyla sınırlayabilirsiniz. Günlüklere yazılan veri miktarını sınırlamak için istemci uygulamanıza kod eklemeniz gerekir. Genellikle, yapılandırma dosyasında istemci tarafı izlemeyi etkinleştirdikten sonra OperationContext sınıfını kullanarak kodda genel olarak kapatırsınız. Örneğin, uygulamanız herhangi bir depolama işlemi gerçekleştirmeden önce bunu Application_Start yöntemindeki ASP.NET bir MVC uygulamasında yapabilirsiniz:

protected void Application_Start()  
{  
    ...  
  
    // Disable Default Logging for Windows Azure Storage  
    OperationContext.DefaultLogLevel = LogLevel.Off;  
  
    // Verify that all of the tables, queues, and blob containers used in this application  
    // exist, and create any that don't already exist.  
    CreateTablesQueuesBlobContainers();  
}  

Ardından, günlük düzeyini tanımlayan özel bir OperationContext nesnesi oluşturarak ilgilendiğiniz belirli işlemler için izlemeyi etkinleştirebilirsiniz. Ardından, aşağıdaki örnekte olduğu gibi operationContext nesnesini depolama işlemini çağırmak için kullandığınız Execute yöntemine parametre olarak geçirin:

[HttpPost]  
[ValidateAntiForgeryToken]  
public ActionResult Create(Subscriber subscriber)  
{  
    if (ModelState.IsValid)  
    {  
       ...  
        var insertOperation = TableOperation.Insert(subscriber);  
        OperationContext verboseLoggingContext = new OperationContext() { LogLevel = LogLevel.Verbose };  
        mailingListTable.Execute(insertOperation, null, verboseLoggingContext);  
        return RedirectToAction("Index");  
    }  
  
    ...  
    return View(subscriber);  
}  
  

İstemci tarafı günlük şeması ve örneği

Aşağıdaki örnek, c3aa328b içeren bir istemci istek kimliğine sahip bir işlem için istemci kitaplığı tarafından oluşturulan istemci tarafı günlüğünden bir ayıklamadır. İstemci istek kimliği, istemci tarafında günlüğe kaydedilen iletilerin ağ izlemeleri ve depolama günlükleriyle ilişkilendirilmesine olanak tanıyan bir bağıntı tanımlayıcısıdır. Bağıntı hakkında daha fazla bilgi için bkz. Azure Depolama'yı izleme, tanılama ve sorunlarını giderme. Ayıklama, günlük dosyalarının içinden gözlemlenebilen bazı önemli bilgilere açıklama (girintili ve italik) ekler.

Aşağıdaki günlük dosyasının ilk satırını kullanarak bu işlevi göstermek için alanlar şunlardır:

Microsoft.Azure.Storage Information: 3 : c3aa328b...: Starting operation with location Primary per location mode PrimaryOnly.
Yukarıdaki izleme iletisi , konum modunun yalnızca birincil olarak ayarlandığını gösterir; başka bir deyişle başarısız bir istek ikincil bir konuma gönderilmez.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Starting synchronous request to https://storageaccountname.table.core.windows.net/mailinglist.
Yukarıdaki izleme iletisi, isteğin zaman uyumlu olduğunu gösterir.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Setting payload format for the request to 'Json'.
Yukarıdaki izleme iletisi, yanıtın JSON olarak biçimlendirilmiş olarak döndürülmesi gerektiğini gösterir.
Microsoft.Azure.Storage Verbose: 4 : c3aa328b...: StringToSign = GET...Fri, 23 May 2014 06:19:48 GMT./storageaccountname/mailinglist.
Yukarıdaki izleme iletisi, kimlik doğrulama hatalarında hata ayıklamak için yararlı olan StringToSign bilgilerini içerir. Ayrıntılı iletiler ayrıca işlem türü ve istek parametreleri de dahil olmak üzere tam istek ayrıntılarını içerir.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Waiting for response.
Yukarıdaki izleme iletisi, isteğin gönderildiğini ve istemcinin yanıt beklediğini gösterir.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Response received. Status code = 200, Request ID = 417db530-853d-48a7-a23c-0c8d5f728178, Content-MD5 = , ETag =
Yukarıdaki izleme iletisi, yanıtın alındığını ve http durum kodunu gösterir.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Response headers were processed successfully, proceeding with the rest of the operation.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Processing response body.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Retrieved '8' results with continuation token ''.
Yukarıdaki izleme iletisi 8 sonuç alındığını ve devamlılık belirteci sağlanmadığını gösterir; başka bir deyişle bu sorgu için başka sonuç yoktur.
Microsoft.Azure.Storage Information: 3 : c3aa328b...: Operation completed successfully.
Yukarıdaki izleme iletisi, işlemin başarıyla tamamlandığını gösterir.

Aşağıdaki iki ayrıntılı (düzey 4) günlük girdisi bir HEAD ve DELETE isteği gösterir ve İşlem Metni alanındaki ayrıntılı bilgileri gösterir:
Microsoft.Azure.Storage Verbose: 4 : 07b26a5d...: StringToSign = HEAD............x-ms-client-request-id:07b26a5d....x-ms-date:Tue, 03 Jun 2014 10:33:11 GMT.x-ms-version:2014-02-14./storageaccountname/azuremmblobcontainer.restype:container.
Microsoft.Azure.Storage Verbose: 4 : 07b26a5d...: StringToSign = DELETE............x-ms-client-request-id:07b26a5d....x-ms-date:Tue, 03 Jun 2014 10:33:12 GMT.x-ms-version:2014-02-14./storageaccountname/azuremmblobcontainer.restype:container.
Yukarıdaki izleme iletisi, belirli bir istekle ilgili ayrıntılı bilgiler de dahil olmak üzere ayrıntılı izleme iletileri içindeki OperationText alanını gösterir. Bu ayrıntılar HTTP işlem türünü (örneğin HEAD, DELETE, POST), istemci istek kimliğini, zaman damgasını, SDK sürümünü ve işleme özgü ek verileri içerir.