Tüm Ürünler
Search
Belge Merkezi

Simple Log Service:,

Son Güncelleme:Sep 30, 2026

Log4j2 tarafından kaydedilen Java uygulama günlüklerini toplamak ve sorgulama ile analiz için Simple Log Service'e göndermek üzere Log4j2 appender veya Logtail kullanabilirsiniz.

Log4j'a genel bakış

Log4j konsollar, dosyalar, GUI bileşenleri, soket sunucuları, NT olay kayıt cihazları ve UNIX Syslog daemon'ları gibi günlük hedeflerini yapılandırmanıza olanak tanıyan açık kaynaklı bir Apache projesidir. Uygulama kodunu değiştirmeden, yalnızca bir yapılandırma dosyası aracılığıyla her günlük girdisinin çıktı biçimini kontrol edebilir ve günlük düzeylerini tanımlayarak günlük oluşturmayı hassas bir şekilde ayarlayabilirsiniz. Log4j üç bileşenden oluşur:

  • düzenler (layouts)

    Düzenler, günlük mesajlarını biçimlendirir. Yaygın düzenler şunlardır:

    Düzen

    Açıklama

    HTMLLayout

    Günlükleri HTML tabloları olarak biçimlendirir.

    SimpleLayout

    INFO düzeyindeki mesajlar için varsayılan biçim gibi basit bir çıktı biçimi kullanır.

    PatternLayout

    Günlükleri özel bir biçimde çıkarır. Zaman damgası, günlük düzeyi, iş parçacığı adı, sınıf adı, yöntem adı ve günlük mesajı gibi öğelerin sırasını ve biçimini belirtebilirsiniz.

  • ekleyiciler (appenders)

    Ekleyiciler, günlük çıktı hedeflerini tanımlar. Yaygın ekleyiciler şunlardır:

    Ekleyici

    Açıklama

    ConsoleAppender

    Günlükleri konsola çıkarır.

    FileAppender

    Günlükleri bir dosyaya çıkarır.

    DailyRollingFileAppender

    Günlükleri bir dosyaya çıkarır ve her gün yeni bir günlük dosyası oluşturur.

    RollingFileAppender

    Günlük mesajlarını belirtilen boyuta kadar bir dosyaya çıkarır. Dosya boyut sınırına ulaştığında yeniden adlandırılır ve yeni bir dosya oluşturulur.

    JDBCAppender

    Günlük mesajlarını bir veritabanına kaydeder.

  • günlükleyiciler (loggers)

    Günlükleyici, günlük mesajlarını yakalar ve günlüğe kaydetme için giriş noktası olarak hizmet verir. Her günlükleyiciye önem derecesine göre bir günlük düzeyi atanır. Log4j, öncelik sırasına göre azalan düzende sekiz günlük düzeyi tanımlar: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE ve ALL. Alt günlükleyiciler, günlük düzeylerini üstlerinden devralır. Aşağıdaki tabloda günlük düzeyleri açıklanmaktadır.

    Günlük düzeyi

    Açıklama

    OFF

    Tüm günlüğü kapatır.

    FATAL

    Uygulamanın çıkmasına neden olacak ciddi bir hata olayını gösterir.

    ERROR

    Sistemin çalışmaya devam etmesine hala izin verebilecek bir hata olayını gösterir.

    WARN

    Potansiyel olarak zararlı bir durumu gösterir.

    INFO

    Uygulamanın ilerlemesini kaba granüler düzeyde vurgular.

    DEBUG

    Uygulamaların hata ayıklamasında yararlı olan ince granüler bilgiler sağlar.

    TRACE

    Program yürütmesini izler, değişkenleri çıkarır ve yürütme akışını gösterir.

    ALL

    Tüm günlük kayıtlarını yazdırır.

Not

Bir günlükleyici birden fazla ekleyiciyle ilişkilendirilebilir ancak bir ekleyici yalnızca bir düzenle ilişkilendirilebilir.

Ön koşullar

Yordam

Not

Bu konudaki örnekler Java ve Log4j2 kullanır. C, C++, .NET ve PL/SQL gibi diğer dillerdeki programlar için de Log4j kullanabilirsiniz. Söz dizimi ve kullanım Java'dakiyle aynıdır.

Adım 1: Log4j2 yapılandırma dosyasını ekleme

  1. Maven projenize bağımlılıkları ekleyin.

    <dependencies>
      <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>2.23.1</version>
      </dependency>
      <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.23.1</version>
      </dependency>
    </dependencies>
  2. Yapılandırma dosyasını değiştirin.

    Varsayılan olarak Log4j2, yapılandırma dosyasını classpath içinde arar. Dosya yoksa manuel olarak oluşturun. Aşağıdaki örnekte log4j2.xml kullanılmaktadır. Günlükleri sırasıyla konsola ve app.log dosyasına çıkarmak için iki ekleyici tanımlanmıştır. Kök günlükleyici düzeyi error olarak ayarlanmış ve konsola çıktı verilmiştir. com.example.demo.log adlı günlükleyici warn olarak ayarlanmış ve dosyaya çıktı verilmiştir. Log4j2'yi yapılandırma hakkında daha fazla bilgi için Log4j – Log4j 2'yi Yapılandırma (apache.org) adresindeki resmi belgelere bakın.

    <!-- status="WARN" sets the internal status of Log4j 2 itself, not the application's logging. It is used to capture and report potential issues during the configuration process. -->
    <Configuration status="WARN">
        <!-- Start: Define two appenders for log output -->
        <Appenders>
            <!-- Defines a console appender named "Console". Logs are printed to the standard system output. -->
            <Console name="Console" target="SYSTEM_OUT">
                <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/>
            </Console>
            <!-- Defines a file appender named "MyFile". Logs are written to the "app.log" file. -->
            <File name="MyFile" fileName="app.log">
                <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss:SSS zzz} [%t] %-5level %logger{36} - %msg%n"/>
            </File>
        </Appenders>
        <!-- End: Define two appenders for log output -->
        <!-- Start: Configure logger behavior -->
        <Loggers>
            <!-- Defines a logger named "com.example.demo.log" and sets its level to warn. It references the "MyFile" appender, which means logs at the warn level and above from this logger are sent to "MyFile". -->
            <Logger name="com.example.demo.log" level="warn">
                <AppenderRef ref="MyFile" />
            </Logger>
            <!-- Defines the root logger and sets its level to error. It references the "Console" appender, which means logs at the error level and above are sent to the console. -->
            <Root level="error">
                <AppenderRef ref="Console" />
            </Root>
        </Loggers>
        <!-- End: Configure logger behavior -->
    </Configuration>
  3. Günlükleyiciyi kullanın.

    Bir günlükleyici örneği almak ve günlük oluşturmak için test kodu yazın:

        public void logExampleDemo() {
            // Get the logger instance named "com.example.demo.log".
            Logger logger = LogManager.getLogger("com.example.demo.log");
            // Record log messages at different levels.
            logger.trace("trace level");
            logger.debug("debug level");
            logger.info("info level");
            logger.warn("warn level");
            logger.error("error level");
            logger.fatal("fatal level");
        }
  4. Örnek günlük çıktısı:

    2024-05-28 13:37:16:295 CST [http-nio-8080-exec-8] TRACE com.example.demo.log - trace level
    2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] DEBUG com.example.demo.log - debug level
    2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] INFO  com.example.demo.log - info level
    2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] WARN  com.example.demo.log - warn level
    2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] ERROR com.example.demo.log - error level
    2024-05-28 13:37:16:296 CST [http-nio-8080-exec-8] FATAL com.example.demo.log - fatal level

Adım 2: Log4j günlüklerini toplama

Not
  • Log4j2 appender yerleşik bir toplama yöntemidir. Log4j2 ile zaten entegre edilmiş uygulamalar için, günlükleri sunucu diskine yazmadan gerçek zamanlı olarak göndermek üzere minimal yapılandırma gerekir. Bu yöntem, büyük hacimli günlük verilerinin gerçek zamanlı işlenmesini gerektiren büyük veri uygulamaları için uygundur.

  • Logtail kullanarak günlükleri toplamak için sunucunuza Logtail aracısını yüklemeniz gerekir. Logtail aracısı çeşitli işleme eklentilerini destekler.

Log4j2 appender aracılığıyla

image
  1. Maven projenize bağımlılıkları ekleyin.

    <dependency>
        <groupId>com.google.protobuf</groupId>
        <artifactId>protobuf-java</artifactId>
        <version>2.5.0</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>aliyun-log-log4j2-appender</artifactId>
        <version>0.1.12</version>
    </dependency>
  2. Yapılandırma dosyasını değiştirin.

    Aşağıdaki örnekte XML yapılandırma dosyası log4j2.xml kullanılmaktadır. Dosya yoksa projenin kök dizininde oluşturun. Loghub ekleyicisini ve günlükleyiciyi aşağıdaki gibi yapılandırın:

    <Appenders>
        <Loghub name="Loghub"
                project="your project"
                logStore="your logStore"
                endpoint="your project endpoint"
                accessKeyId="your accessKey id"
                accessKeySecret="your accessKey secret"
                totalSizeInBytes="104857600"
                maxBlockMs="0"
                ioThreadCount="8"
                batchSizeThresholdInBytes="524288"
                batchCountThreshold="4096"
                lingerMs="2000"
                retries="10"
                baseRetryBackoffMs="100"
                maxRetryBackoffMs="100"
                topic="your topic"
                source="your source"
                timeFormat="yyyy-MM-dd'T'HH:mmZ"
                timeZone="UTC"
                ignoreExceptions="true">
            <PatternLayout pattern="%d %-5level [%thread] %logger{0}: %msg"/>
        </Loghub>
    </Appenders>
    <Loggers>
        <Root level="warn">
            <AppenderRef ref="Loghub"/>
        </Root>
    </Loggers>

    project, Logstore, endpoint, accessKeyId ve accessKeySecret parametreleri zorunludur. İsteğe bağlı parametreler belirtilmezse varsayılan değerler kullanılır. Aşağıdaki tabloda parametreler açıklanmaktadır.

    Parametre

    Açıklama

    project

    Simple Log Service'deki Project adınız.

    Logstore

    Simple Log Service'deki Logstore adınız.

    endpoint

    Simple Log Service için genel uç nokta. Daha fazla bilgi için bkz. Hizmet uç noktası.

    accessKeyId

    AccessKey ID. Daha fazla bilgi için bkz. AccessKey Oluşturma.

    accessKeySecret

    AccessKey gizli anahtarı. Daha fazla bilgi için bkz. AccessKey Oluşturma.

  3. Test kodu örneği:

    import org.apache.logging.log4j.LogManager;
    import org.apache.logging.log4j.Logger;
    public class Log4j2AppenderExample {
        private static final Logger LOGGER = LogManager.getLogger(Log4j2AppenderExample.class);
        public static void main(String[] args) throws InterruptedException {
            LOGGER.trace("log4j2 trace log");
            LOGGER.debug("log4j2 debug log");
            LOGGER.info("log4j2 info log");
            LOGGER.warn("log4j2 warn log");
            LOGGER.error("log4j2 error log", new RuntimeException("Runtime Exception"));
            Thread.sleep(1000 * 5);
        }
    }

Logtail aracılığıyla

image
Önemli

Logtail'i yapılandırırken dosya yolunu belirtmeniz gerekir. Uygulama günlüklerinin günlük dosyalarına yazılabilmesini sağlayın.

Simple Log Service, Logtail kullanarak metin günlüklerini hızlıca toplamak için bir yapılandırma sihirbazı sağlar. ECS örneğiniz ve Simple Log Service Project'iniz aynı hesap altında ve aynı bölgede ise bkz. Sunuculardan metin günlüklerini toplama. Aksi takdirde bkz. Sunuculardan metin günlüklerini toplamak için Logtail'i manuel olarak yükleme.

Adım 3: Günlükleri görüntüleme

  1. Simple Log Service konsolu üzerinde oturum açın.

  2. Projects bölümünde istediğiniz projeyi tıklayın.

    image

  3. Log Storage > Logstores sekmesinde istediğiniz logstore'u tıklayın.

    image

  4. Günlük verilerinin yüklendiğini doğrulayın. Logstore'da günlükleri hızlıca görüntülemek için Consumption Preview öğesini tıklayın. Daha fazla bilgi için bkz. Sorgulama ve analiz hızlı başlangıcı.

  5. Günlükleri sorgulayın ve analiz edin.

    Önemli

    Günlükler bir Logstore'a yüklendikten sonra, bunları sorgulayıp analiz edebilmeniz için bir dizin oluşturmanız gerekir. Dizin yapılandırması hakkında bilgi için bkz. Dizin oluşturma.

    Bir sorgu ifadesi girin ve ardından bir zaman aralığı belirtmek için Last 15 Minutes öğesini tıklayın. Aşağıda örnek bir günlük gösterilmektedir:

    level: ERROR
    location: com.aliyun.openservices.log.log4j.example.Log4jAppenderExample.main(Log4jAppenderExample.java:16)
    message: error log
    throwable: java.lang.RuntimeException: xxx
    thread: main
    time: 2018-01-02T03:15+0000
    log: 0 [main] ERROR com.aliyun.openservices.log.log4j.example.Log4jAppenderExample - error log
    __source__: xxx
    __topic__: yyy

    Logstore sayfasında günlükleri sorgulayın ve analiz edin.

    Günlük verilerini görüntülemek, aramak ve filtrelemek için bir sorgu ifadesi girin. Daha fazla bilgi için bkz. Günlükleri sorgulama ve analiz etme. Örnekler:

    • Son bir saatte en çok hata içeren ilk üç konumu sorgulayın.

      level: ERROR | select location ,count(*) as count GROUP BY  location  ORDER BY count DESC LIMIT 3
    • Son 15 dakikadaki her günlük düzeyi için günlük sayısını sayın.

      | select level ,count(*) as count GROUP BY level ORDER BY count DESC

Sorun giderme

Log4j2 appender'ı yapılandırdıktan sonra günlük toplama başarısız olursa aşağıdaki yaygın nedenleri kontrol edin.

1. Bağımlılık seçimi

Spring Boot varsayılan olarak Logback kullanır. Uygulamanız Spring Boot kullanıyorsa Log4j2 appender yerine aliyun-log-logback-appender bağımlılığını ekleyin. Uygulamanız Log4j2 kullanıyorsa aliyun-log-log4j2-appender bağımlılığını kullanın.

2. Uç nokta yapılandırması

cn-hangzhou.log.aliyuncs.com gibi doğru genel uç noktayı yapılandırdığınızdan emin olun.

3. AccessKey ID ve AccessKey gizli anahtar izinleri

RAM kullanıcısına AliyunLogFullAccess izninin veya hedef LogStore üzerindeki yazma izinlerinin verildiğinden emin olun.

4. Project ve LogStore adları

Yapılandırmanızdaki Project ve LogStore adlarının Simple Log Service konsolunda gösterilen adlarla eşleştiğinden emin olun.

İlgili belgeler