Günlüğü dışa aktarma, arşiv indirme ve bütünlüğü doğrulama

Ne zaman kullanılır

Günlüğe dosya olarak ihtiyaç duyduğunuzda: bir olay seçimini harici bir sisteme göndermek, bir seçimi olay soruşturmasına eklemek veya bir denetçiye bir döneme ait tüm kayıtları sağlamak için. Bu sayfa ayrıca arşivlerle — otomatik arşivleme tarafından günlük tablosundan kaldırılan kayıtlarla — çalışmayı ve günlüğün değiştirilmediğini doğrulayan karma zinciri doğrulamasını başlatmayı da kapsar.

Her şey Security Event Log ekranında yapılır: dışa aktarımlar ve doğrulama Current events sekmesinde, arşivler Archived events sekmesinde, ayarlar ise Actions menüsündedir.

Bu üç işlem üç farklı amaca hizmet eder ve birbirinin yerine kullanılmamalıdır.

Görev	Neye tıklanır	Ne elde edersiniz
Filtrelere dayalı tek seferlik bir seçim	Current events sekmesinde CSV veya JSON	tarayıcının indirilenler klasöründe bir dosya; kümede saklanmaz
Geçmiş dönemlere ait kayıtlar	Archived events sekmesindeki arşiv boyutu	kalıcı depolamadan bir .csv.gz arşiv dosyası
Günlüğün değiştirilmediğinin kanıtı	Verify integrity	SHA-256 karma zincirinin taranması ve son doğrulamaya ilişkin bir rapor

Olayları okumak ve filtrelemek için Günlüğü okuma ve olayları filtreleme; günlük modeli için Güvenlik günlüğü sayfasına bakın.

Ön koşullar

• küme düzeyinde genel bir rol — Cluster master veya Security Admin. İşleme göre yetkiler: ExportSecurityLog — dışa aktarma, ViewSecurityArchive — arşivleri listeleme, ExportSecurityArchive — arşiv indirme, ViewSecurityArchiveSettings — arşiv ayarlarını okuma, VerifySecurityLog (id 10002) — doğrulamayı başlatma. Arşiv ayarlarını düzenleme (EditSecurityArchiveSettings, id 10006) yalnızca Cluster master için kullanılabilir;
• vStack Center sürümü — 3.0.3;
• dosyayı arayüzü atlayarak doğrudan oradan almanız gerekiyorsa yönetim düğümündeki arşiv dizinine erişim.

Adımlar

Adım 1. Olayları bir dosyaya aktarın

1. Soldaki gezinme ağacında Sites → ilgili küme → Security Event Log öğesini açın.

2. Current events sekmesinde kalın.

3. Seçimi daraltın: zaman aralığını Select date ile ayarlayın ve gerekirse huni panelinde filtreleri ayarlayın. Dışa aktarım, gördüğünüz tabloyla aynı filtreleri ve zaman aralığını kullanır.

4. İstediğiniz biçim için tablonun üzerindeki CSV veya JSON düğmesine tıklayın. Dosya oluşturulurken düğmede bir dönen simge görünür.

   

Küme tamamlanan dosyayı tarayıcıya gönderir, tarayıcı da onu indirilenler klasörüne kaydeder. Dosya kümede kalmaz: aynı seçimi yeniden almak için dışa aktarımı tekrarlayın.

Tek bir dışa aktarım 100 000 kayıtla sınırlıdır. Filtrelerle daha fazla kayıt eşleşirse arayüz dosya oluşturmaz; seçimdeki kayıt sayısını bildirir ve filtreleri daraltmanızı ister.

Adım 2. Arşiv listesini görüntüleyin

Otomatik arşivleme eski günlük kayıtlarını sıkıştırılmış CSV dosyalarına taşır. Archived events sekmesi bunları gösterir.

Sütun	Ne gösterir
Period	arşivin kapsadığı dönem
Records	arşivdeki kayıt sayısı
Size	dosya boyutu; bu değer aynı zamanda indirme düğmesidir
Checksum	SHA-256 sağlama toplamı; hücre sağlama toplamının başlangıcını, araç ipucu ise tam değeri gösterir ve kopyalamanıza olanak tanır
Created	arşivin oluşturulduğu zaman

Hâlâ oluşturulmakta olan bir arşiv de listede görünür, ancak kayıt sayısı, sağlama toplamı veya zaman olmadan; boyutun yerinde dönen bir simge görünür. Bu dosyayı indirmek için henüz erkendir.

Search in table beş sütunun tümünde arama yapar — belirli bir döneme ait arşivi bulmak için kullanışlıdır.

Adım 3. Arşivi indirin ve kontrol edin

Size sütunundaki dosya boyutuna tıklayın — küme sağlama toplamını kontrol eder ve dosyayı tarayıcıya gönderir. İndirmeden önce Checksum sütunundaki değeri kopyalayın: bu, karşılaştırma için referans değerdir.

İndirilen dosyayı kendi tarafınızda kontrol edin — sağlama toplamını ve açılabilirliğini:

shasum -a 256 security_log_a3f1b2c4_03_01_2025.csv.gz
gunzip -t security_log_a3f1b2c4_03_01_2025.csv.gz && echo "архив целый"

Sağlama toplamı Checksum sütunundaki değerle eşleşmelidir. Dışa aktarımın aksine arşiv, indirildikten sonra yönetim düğümündeki depolama dizininde kalır — yeniden alınabilir.

Adım 4. Otomatik arşivlemeyi etkinleştirin veya devre dışı bırakın

Autoarchiving anahtarı, Current events sekmesinde tablonun üzerindedir. ON eski kayıtların tablodan kaldırıldığı anlamına gelir; OFF bunu devre dışı bırakır. Arayüz, devre dışı anahtarın yanında bir uyarı gösterir.

Otomatik arşivleme devre dışıyken günlük tablosu kayıt kaldırılmadan büyür ve yeni arşiv oluşturulmaz. Boş alanı kendiniz izleyin.

Anahtar değiştirildikten sonra otomatik arşivlemenin yeni durumuna ilişkin bir ileti görünür ve olay listesi yeniden yüklenir.

Adım 5. Arşiv ayarlarını düzenleyin

1. Tablonun üzerindeki Actions düğmesine tıklayın ve Archive settings öğesini seçin.
2. Form alanlarını doldurun:

Alan	Neyi denetler	Sınırlar
Max log size (MB)	eski kayıtların kaldırılmasını tetikleyen günlük tablosu boyut eşiği	10 MB ile 16 GB arası, yani 10 ile 16384 arası
Disk space alert threshold (MB)	altına düşüldüğünde kümenin uyarı verdiği boş alan eşiği	en az 100
Archive path	arşiv depolama dizini	uzunluk 1–256 karakter

3. Save düğmesine tıklayın.

Her iki boyut da megabayt cinsinden belirtilir — form bunları kümenin birimlerine dönüştürür. Formda hiçbir şey değişmediği veya bir değer doğrulamadan geçemediği sürece Save devre dışı kalır. Kaydettikten sonra "Archive settings updated" iletisi görünür.

Actions menüsündeki Archive settings öğesi yalnızca Cluster master için kullanılabilir: Security Admin ayarları görüntüleyebilir ancak değiştiremez.

Adım 6. Karma zinciri doğrulamasını başlatın

1. Current events sekmesinde tablonun üzerindeki Verify integrity düğmesine tıklayın.
2. Onay iletişim kutusunda SHA-256 karma zinciri doğrulamasının günlüğün tamamı için çalışacağını okuyun, ardından Start düğmesine tıklayın. Vazgeçmek için Cancel düğmesine tıklayın.

Doğrulama arka planda çalışır: küme günlüğü parçalara böler ve bunları eşzamanlı olarak denetler. Doğrulama çalışırken Verify integrity tamamlanma yüzdesini gösterir ve başka bir tıklamayı kabul etmez — kümede aynı anda yalnızca bir doğrulama çalışır. Ekranı açık tutmanız gerekmez: sonuç son doğrulama raporunda kalır.

Adım 7. Doğrulama sonucunu okuyun

Doğrulama bittiğinde "Integrity verification completed" iletisi görünür ve düğmenin yanında Last verify integrity raporu belirir — son doğrulamanın zamanı ve sonucu.

Raporun gösterdiği	Anlamı
yeşil bir işaret ve bir kayıt sayısı	zincir sağlam; tüm günlük kayıtları denetlendi
kırmızı bir işaret ve bir kayıt ID değeri	zincir bu kayıtta kırık; kimliğe tıklamak kaydın kartını açar
"Verification failed" araç ipucuna sahip bir simge	doğrulama tamamlanmadı; yeniden çalıştırın

Zincir kırık olduğunda incelemeye, kimliği raporda görünen kayıtla başlayın: günlük o kayda kadar tutarlıdır ve bağlantı orada kopar.

Sonucu doğrulayın

Dışa aktarım: dosya tarayıcının indirilenler klasöründe görünür ve açılır, satır sayısı da tablonun altındaki kayıt sayacıyla eşleşir.

Arşiv: indirilen dosyanın sağlama toplamı Checksum sütunuyla eşleşir ve gunzip -t hatasız tamamlanır.

Zincir doğrulaması: Verify integrity artık yüzde göstermez, Last verify integrity ise zamanı, yeşil bir işareti ve denetlenen kayıt sayısını gösterir. Kayıt kimliğiyle birlikte kırmızı bir işaret bunun tersini — zincirin kırık olduğunu — gösterir.

Sorun giderme

Dışa aktarım başlamıyor: seçim 100 000 kaydı aşıyor. Arayüz seçimde kaç kayıt olduğunu bildirir ve filtreleri daraltmanızı ister. Geçici çözüm — zaman aralığını veya kategoriyi daraltın ve günlüğü parçalar hâlinde alın; eski dönemler için arşivleri kullanın. Küme, arayüz dışından yapılan isteklere de aynı sınırı uygular — -24001 reddi.

Dışa aktarma dosyası oluşturulmadı, yazma hatası (-24002). Dosya yönetim düğümüne yazılamadı; yaygın bir neden yetersiz boş alandır. Düğümün boş alanını ve arşiv ayarlarındaki Disk space alert threshold (MB) değerini kontrol edin.

Arşiv indirilmedi: dosya bulunamadı (-24003). Arşiv listesi güncel değil — dosya depolama dizininden zaten kaldırılmış. Geçici çözüm — Archived events sekmesini yenileyin ve arşivi güncellenmiş listeden indirin.

Arşiv sunulmuyor: sağlama toplamı uyuşmazlığı (-24004). Küme dosyayı sunmadan önce SHA-256 değerini kontrol eder ve göndermeyi reddetmiştir: diskteki arşiv bozuktur. Böyle bir dosya "onarılamaz" — kayıtlar hâlâ oradaysa ilgili dönemi günlük tablosundan dışa aktarın ve depolama ortamını inceleyin.

Arşiv boyutuna tıklanamıyor; yerine dönen bir simge görünüyor (-24008). Arşiv hâlâ oluşturuluyor: kayıt sayısı, sağlama toplamı veya oluşturma zamanı yok. Geçici çözüm — bu alanlar görünene kadar bekleyin, ardından indirmeyi yeniden deneyin.

Arşiv ayarları kaydedilmiyor (-24006, -24007). Bir değer sınırların dışında: günlük boyutu 10 ile 16384 MB aralığının dışında, boş alan eşiği 100 MB'ın altında veya yol çok uzun. Geçici çözüm — 5. adımdaki sınırlar tablosunu kontrol edin. Değer düzeltilene kadar Save devre dışı kalır.

Verify integrity düğmesine tıklanamıyor (-11201). Zincir doğrulaması zaten çalışıyor ve küme ikincisini başlatmaz. Geçici çözüm — bitmesini bekleyin: düğmedeki yüzde ilerlemeyi gösterir.

Actions menüsünde Archive settings öğesi yok. Rolde arşiv ayarlarını düzenleme yetkisi yoktur — bunu yalnızca Cluster master yapabilir.

İndirilen .csv.gz dosyası açılamıyor ve boyutu Size sütunundaki değeri aşıyor. Bu ayrı bir sorundur — arayüz üzerinden indirme sırasında arşivin bozulması. İnceleme ve geçici çözüm: İndirilen güvenlik günlüğü arşivi açılamıyor.

API yöntemleri

Bu sayfada ele alınan API işlemleri: security-event-export, security-event-archive-list, security-event-archive-export, security-event-archive-settings-get, security-event-archive-settings-set, security-event-log-verify, security-event-log-status, security-verification-statuses — bkz. API başvurusu.

Ayrıca bkz.

• Güvenlik günlüğü — karma zinciri, doğrulama durumları ve arşiv ayarları.
• Günlüğü okuma ve olayları filtreleme — dışa aktarımı oluşturmak için kullanılan filtreler.
• İndirilen güvenlik günlüğü arşivi açılamıyor — bozuk bir arşiv dosyasının sorununu giderme.
• Roller ve yetkiler — dışa aktarma, arşiv ve doğrulama yetkileri.