Share via


Olay hedef

Olay dosyası hedef tam arabelleklerini diske yazar bir hedeftir.

Aşağıdaki tabloda olay dosyası hedef yapılandırmak için kullanılabilir seçenekleri açıklar.

Seçenek

Izin verilen değerler

Açıklama

filename

Herhangi bir, en fazla 260 karakter dize. Bu değer gereklidir.

Dosya konumu ve dosya adı.

Herhangi bir dosya adı uzantısını kullanabilirsiniz.

max_file_size

Herhangi bir 64 bit tamsayı. Bu, isteğe bağlı bir değerdir.

Maksimum dosya boyutu megabayt (mb). Eğer max_file_sizebelirtilmezse, dosya disk dolu olduğu kadar büyümek. Varsayılan dosya boyutu 1 GB'dır.

max_file_sizegeçerli oturumu arabellek boyutundan büyük olmalıdır. Değilse, hedef başlatmak, raporlama başarısız olur max_file_sizegeçersiz. Arabellek geçerli boyutunu görüntülemek için buffer_sizesütununda sys.dm_xe_sessions yönetimi görüntüleyin.

Varsayılan dosya boyutu oturumu arabellek boyutundan daha küçükse, ayar önerilir max_file_size içinde belirtilen değere max_memorysütununda sys.server_event_sessions Katalog görünümü.

Ne zaman max_file_sizeayarlı bir boyutu oturumu arabellek boyutundan büyük, onu en yakın birden çok oturumu arabellek boyutunu yuvarlanmasını. Bu belirtilen değerden daha küçük bir hedef dosya yaratabilir max_file_size. Örneğin, arabellek boyutu 100 mb ise ve max_file_sizeayarlanır ikinci bir tampon kalan 50 mb alan içinde uygun değildir çünkü 150 mb, elde edilen dosya boyutu 100 mb aşağı doğru yuvarlanır.

Varsayılan dosya boyutu oturumu arabellek boyutundan daha küçükse, ayar önerilir max_file_size değeri max_memorysütununda sys.server_event_sessions Katalog görünümü.

max_rollover_files

Herhangi bir 32 bit tamsayı. Bu, isteğe bağlı bir değerdir.

Dosyaları dosya sistemi korumak için en fazla sayısı.

increment

Herhangi bir 32 bit tamsayı. Bu, isteğe bağlı bir değerdir.

Megabayt (mb), dosya için artan bir büyüme. Belirtilmezse, varsayılan değer artışı için oturumu arabellek boyutunun iki katı olduğunu.

İlk kez bu hedef bir olay oluşturulur, belirttiğiniz dosya adı _0_ ve bir uzun tamsayı değeri eklenir. Tamsayı değeri 1 Ocak 1600 arasındaki milisaniye sayısı olarak hesaplanır ve Tarih ve saati dosyası oluşturulur. İzleyen aktarma dosyaları da bu biçimi kullanın. Uzun tamsayı değerini inceleyerek gelen en güncel dosya belirleyebilirsiniz. Dosyalar belirttiğiniz bir senaryo nasıl adlandırıldığı aşağıdaki örnekte gösterilmiştir filenameolarak C:\OutputFiles\MyOutput.xel:

  • ilk dosya hazırlandı - C:\OutputFiles\MyOutput_0_128500310259380000.xel

  • ilk aktarma dosya - C:\OutputFiles\MyOutput_0_128505831770890000.xel

  • ikinci aktarma dosya - C:\OutputFiles\MyOutput_0_132410772966237000.xel

Bir oturumu hedef ekleme

Oluşturduğunuzda veya olay oturumu, alter olay hedef için Genişletilmiş olayları oturumu eklemek için aşağıdaki ifadeleri yer alacağını yerine file_nameistenen dosya adı ve yolu:

ADD TARGET package0.event_file(
   SET filename='file_name.xel')

Hedef çıkış gözden geçirme

Çıkış dosyası hedef gözden geçirmek için kullanmanız gereken sys.fn_xe_file_target_read_fileişlevi. Verileri xml olarak dökme öneririz. Aşağıdaki sözdizimi kullanabilirsiniz yerine file_namehedefi otelde eklediğiniz belirtilen yolu ve dosya adı:

SELECT *, CAST(event_data AS XML) AS 'event_data_XML'
FROM sys.fn_xe_file_target_read_file('file_name*.xel', NULL, NULL, NULL)

Ayrıca bkz.

Başvuru

fn_xe_file_target_read_file (Transact-sql)

OLAY SESSION (Transact-sql) oluştur

alter olay SESSION (Transact-sql)

Kavramlar

SQL Server Genişletilmiş olayları hedefleri