2026.09.2 — Denetim ve Login Log Tablosu ALTER Scriptleri

Bu sayfa listelenmemiştir (unlisted) — sidebar'da ve arama sonuçlarında görünmez, yalnızca 2026.09.2 sürüm notlarındaki doğrudan bağlantı üzerinden erişilmek üzere tasarlanmıştır.

Kimler ihtiyaç duyar

Bu script yalnızca Denetim Kayıtları'nı veya Giriş Kayıtları'nı SQL/JDBC connector'ı üzerinden ilişkisel bir veritabanına (Oracle, MySQL, PostgreSQL veya SQL Server) yazan Apinizer kurulumlarını ilgilendirir — yani bu iki ekran için yapılandırılmış log hedeflerinizden biri log_AuditEvent ve/veya log_LoginLog ise.

Elasticsearch veya MongoDB connector'ı kullanıyorsanız bu sayfayı tamamen atlayın — o hedefler yeni alanları elle bir adım gerektirmeden zaten taşır.

Ne değişti

Apinizer 2026.09.2, Denetim Kayıtları ve Giriş Kayıtları ekranlarının ekranda zaten gösterdiği istek-bağlamı bilgisini — isteği kimin, nereden yaptığını ve ilişkili kayıtların birbiriyle nasıl eşleştiğini — ilişkisel Denetim Olayı ve Login Log tablolarına da ekler.

log_AuditEvent altı yeni kolon alır:

• event_type — Denetim Kayıtları olay tiplerinden hangisi olduğu.
• outcome — SUCCESS, FAILURE veya DENIED.
• client_ip — istemcinin gerçek IP adresi.
• user_agent — istemcinin gönderdiği User-Agent başlığı.
• correlation_id — bu kaydı isteğin diğer log kayıtlarına bağlar.
• source — isteğin geldiği yüzey (Yönetim Konsolu, APIOps, API Portal veya System).

log_LoginLog üç yeni kolon alır: user_agent, reason_code (bir başarısızlık, kilitlenme veya parola olayının ardındaki makine-okunur neden) ve target_project_id (proje değişimi olayında oturumun geçtiği proje).

Ertelemek opsiyonel değil

Bu sitedeki trafik-log ALTER scriptlerinin aksine, bu iki INSERT koşulsuzdur — "kolon yoksa atla" gibi bir yedek davranış bulunmaz. 2026.09.2'ye bu scripti çalıştırmadan yükseltirseniz, kurulumunuzun bu ilişkisel tabloya yazmaya çalıştığı her Denetim Olayı veya Login Log satırı başarısız olur; bu, kaydı üreten isteği çökertmeden yakalanıp hata olarak loglanır:

• Bu şekilde başarısız olan bir Denetim Olayı yazımı yine de yapılandırılmış failover connector'ınıza düşer — olay mutlaka kaybolmaz, yalnızca gecikir veya failover ayarınıza göre başka bir hedefe yönlenir.
• Bu şekilde başarısız olan bir Login Log yazımında failover yoktur — satır tamamen düşer. Bu tabloya ulaşması gereken başarısız bir giriş, bir oturum kapatma veya bir parola olayı hiçbir zaman oraya ulaşmaz.

Yeni kurulumlar bundan etkilenmez: Apinizer Log Tabloları Oluşturma Komutları sayfasındaki CREATE TABLE ifadeleri dokuz kolonun tamamını zaten içerir.

Ne zaman çalıştırılmalı

Bu script'i, Denetim Olayı veya Login Log kaydı alan her SQL/JDBC veritabanına karşı bir kez, 2026.09.2 yükseltmesinden önce çalıştırın — yazım yolu burada fail-soft olmadığı için "yükseltme sırasında" çalıştırmak, kayıtların zaten düşmeye başladığı bir pencere riski taşır. DDL için bir değişiklik yönetimi süreciniz varsa önce production dışı bir ortamda deneyin.

Kurulumunuz bu iki kayıt tipinden yalnızca birini ilişkisel bir veritabanına gönderiyorsa (örneğin Denetim Kayıtları Elasticsearch'e, Giriş Kayıtları ise bir SQL veritabanına), yalnızca gerçekten kullandığınız tablonun ALTER ifadesini çalıştırmanız yeterlidir.

Oracle

ALTER TABLE log_AuditEvent ADD (
    event_type VARCHAR2(32),
    outcome VARCHAR2(16),
    client_ip VARCHAR2(64),
    user_agent VARCHAR2(512),
    correlation_id VARCHAR2(255),
    source VARCHAR2(32)
);

ALTER TABLE log_LoginLog ADD (
    user_agent VARCHAR2(512),
    reason_code VARCHAR2(64),
    target_project_id VARCHAR2(255)
);

MySQL

ALTER TABLE log_AuditEvent
    ADD COLUMN event_type VARCHAR(32),
    ADD COLUMN outcome VARCHAR(16),
    ADD COLUMN client_ip VARCHAR(64),
    ADD COLUMN user_agent VARCHAR(512),
    ADD COLUMN correlation_id VARCHAR(255),
    ADD COLUMN source VARCHAR(32);

ALTER TABLE log_LoginLog
    ADD COLUMN user_agent VARCHAR(512),
    ADD COLUMN reason_code VARCHAR(64),
    ADD COLUMN target_project_id VARCHAR(255);

PostgreSQL

ALTER TABLE log_AuditEvent
    ADD COLUMN event_type VARCHAR(32),
    ADD COLUMN outcome VARCHAR(16),
    ADD COLUMN client_ip VARCHAR(64),
    ADD COLUMN user_agent VARCHAR(512),
    ADD COLUMN correlation_id VARCHAR(255),
    ADD COLUMN source VARCHAR(32);

ALTER TABLE log_LoginLog
    ADD COLUMN user_agent VARCHAR(512),
    ADD COLUMN reason_code VARCHAR(64),
    ADD COLUMN target_project_id VARCHAR(255);

SQL Server

ALTER TABLE log_AuditEvent ADD
    event_type NVARCHAR(32),
    outcome NVARCHAR(16),
    client_ip NVARCHAR(64),
    user_agent NVARCHAR(512),
    correlation_id NVARCHAR(255),
    source NVARCHAR(32);

ALTER TABLE log_LoginLog ADD
    user_agent NVARCHAR(512),
    reason_code NVARCHAR(64),
    target_project_id NVARCHAR(255);

Doğrulama

Script'i çalıştırdıktan sonra bir Denetim Kaydı üreten bir işlem yapın (örneğin herhangi bir varlığı kaydedin) ve satırın yeni kolonları taşıdığını doğrulayın:

SELECT id, audit_event_date, principal, event_type, outcome, client_ip, correlation_id, source
FROM log_AuditEvent
ORDER BY audit_event_date DESC;

Ardından Yönetim Konsolu'na bir kez giriş yapıp Login Log satırını kontrol edin:

SELECT id, log_timestamp, source, principal, event_type, user_agent, reason_code
FROM log_LoginLog
ORDER BY log_timestamp DESC;

Yeni kurulumlarda bir işlem gerekmez — Apinizer Log Tabloları Oluşturma Komutları sayfasındaki CREATE TABLE ifadeleri kolonları zaten içerir.