10장. JBoss EAP로 로깅


JBoss EAP는 내부 사용과 배포된 애플리케이션에 모두 구성 가능한 로깅 기능을 제공합니다. 로깅 하위 시스템은 JBoss LogManager를 기반으로 하며 JBoss Logging 외에도 여러 타사 애플리케이션 로깅 프레임워크를 지원합니다.

10.1. JBoss EAP의 로깅 메커니즘

JBoss EAP는 서버 환경 모니터링, 문제 해결 및 관리를 지원하는 다양한 로깅 메커니즘을 제공합니다. 이러한 메커니즘을 이해하면 JBoss EAP 설정을 유지 관리하고 디버깅하는 데 도움이 됩니다.

10.1.1. JBoss EAP에서 서버 로깅

JBoss EAP에서 서버 로깅은 주로 server.log 파일을 통해 관리되며 모든 로그 항목이 기록됩니다.

이 로그 파일의 위치는 작동 모드에 따라 다릅니다.

  • 독립 실행형 서버: EAP_HOME/standalone/log/server.log
  • Managed domain: EAP_HOME/domain/servers/SERVER_NAME/log/server.log

이 파일은 일반적으로 서버 로그라고 합니다.

10.1.2. JBoss EAP에서 부팅 로깅

부팅 중에 JBoss EAP는 Java 환경과 각 서비스의 시작에 대한 정보를 기록합니다. 이 로그는 문제 해결에 유용하며 기본적으로 서버 로그에 기록됩니다.

부트업 로깅 로깅은 JBoss EAP 로깅 하위 시스템이 시작될 때까지 사용되는 logging.properties 파일에 구성됩니다.

파일 위치는 작동 모드에 따라 다릅니다.

  • 독립 실행형 서버: EAP_HOME/standalone/configuration/logging.properties
  • 관리형 도메인: 도메인 컨트롤러와 각 서버 모두에 대해 logging.properties 파일이 있습니다.

    • 도메인 컨트롤러: EAP_HOME/domain/configuration/logging.properties
    • Server: EAP_HOME/domain/servers/SERVER_NAME/data/logging.properties

      주의

      필요한 경우가 아니면 logging.properties 파일을 직접 편집하지 마십시오. 특정 사용 사례가 있는 경우 변경하기 전에 Red Hat 고객 포털 을 참조하십시오.

      시작 시 logging.properties 파일에 대한 수동 수정 사항을 덮어씁니다.

10.1.2.1. 부팅 오류 보기

JBoss EAP 문제를 해결할 때 부팅 오류를 확인하는 것이 중요한 단계입니다. 이 정보를 사용하여 오류를 진단하고 해결할 수 있습니다. 필요한 경우 부팅 오류 문제 해결에 도움이 되도록 지원 케이스를 작성하십시오.

다음과 같은 방법으로 부팅 오류를 볼 수 있습니다.

  • server.log 파일에서 부팅 오류 검토
  • 관리 CLI 명령을 사용하여 부팅 오류 읽기

각 방법은 요구 사항에 따라 고유한 이점이 있습니다.

10.1.2.1.1. server.log 파일에서 부팅 오류 검토

server.log 파일을 열어 부팅 중에 발생한 오류를 볼 수 있습니다.

이 방법은 관련 정보와 함께 오류 메시지를 제공하여 오류의 원인을 이해하는 데 도움이 됩니다. 오류 메시지를 일반 텍스트 형식으로 표시합니다.

사전 요구 사항

  • JBoss EAP 서버의 파일 시스템에 액세스할 수 있습니다.
  • 검토를 위해 server.log 파일에 액세스할 수 있습니다.

프로세스

  1. 파일 뷰어에서 server.log 파일을 엽니다.
  2. 파일의 끝으로 이동합니다.
  3. 최신 부팅 순서의 시작을 나타내는 WFLYSRV0049 메시지 식별자가 뒤로 검색됩니다.
  4. 해당 시점부터 ERROR 인스턴스의 로그를 검색합니다. 각 인스턴스에는 오류에 대한 설명이 포함되어 있으며 관련 모듈을 나열합니다.

    다음은 server.log 로그 파일의 오류 설명 예입니다.

    2016-03-16 14:32:01,627 ERROR [org.jboss.msc.service.fail] (MSC service thread 1-7) MSC000001: Failed to start service jboss.undertow.listener.default: org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
            at org.wildfly.extension.undertow.ListenerService.start(ListenerService.java:142)
            at org.jboss.msc.service.ServiceControllerImpl$StartTask.startService(ServiceControllerImpl.java:1948)
            at org.jboss.msc.service.ServiceControllerImpl$StartTask.run(ServiceControllerImpl.java:1881)
            at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
            at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
            at java.lang.Thread.run(Thread.java:745)
    Caused by: java.net.BindException: Address already in use
            ...
    Copy to Clipboard Toggle word wrap
10.1.2.1.2. 관리 CLI 명령을 사용하여 부팅 오류 읽기

JBoss EAP 문제를 해결할 때 read-boot-errors 관리 CLI 명령을 사용하여 부팅 중에 보고된 오류를 볼 수 있습니다.

이 방법은 서버의 파일 시스템에 액세스할 수 없으므로 스크립팅을 통해 원격 모니터링 및 오류 검사를 활성화합니다. 관리 CLI 명령을 사용하면 부팅 오류를 식별하고 해결할 수 있습니다. 예를 들어 여러 JBoss EAP 인스턴스를 시작하고 부팅 오류를 확인하는 스크립트를 작성할 수 있습니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.
  • 관리 CLI에 액세스할 수 있습니다.

프로세스

  1. 관리 CLI를 시작합니다.

    $ <EAP_HOME>/bin/jboss-cli.sh
    Copy to Clipboard Toggle word wrap
  2. 다음 관리 CLI 명령을 실행합니다.

    /core-service=management:read-boot-errors
    Copy to Clipboard Toggle word wrap
  3. 출력을 검토하여 부팅 중에 발생한 오류 목록을 확인합니다.

    출력 예
    {
        "outcome" => "success",
        "result" => [
            {
                "failed-operation" => {
                    "operation" => "add",
                    "address" => [
                        ("subsystem" => "undertow"),
                        ("server" => "default-server"),
                        ("http-listener" => "default")
                    ]
                },
                "failure-description" => "{\"WFLYCTL0080: Failed services\" => {\"jboss.undertow.listener.default\" => \"org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
        Caused by: java.net.BindException: Address already in use\"}}",
                "failed-services" => {"jboss.undertow.listener.default" => "org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
        Caused by: java.net.BindException: Address already in use"}
            }
            ...
        ]
    }
    Copy to Clipboard Toggle word wrap

10.1.3. JBoss EAP의 가비지 컬렉션 로깅

가비지 컬렉션 로깅은 모든 가비지 컬렉션 활동을 일반 텍스트 로그 파일로 기록합니다. 이러한 로그는 진단 목적에 유용합니다.

가비지 컬렉션 로그는 EAP_HOME/standalone/log/gc.log.DIGIT.current 에 있습니다. 각 로그 파일은 3MB로 제한되며 최대 5개의 파일이 순환됩니다.

문제 해결에 도움이 되고 오버헤드가 최소화되므로 가비지 컬렉션 로깅이 활성화된 상태로 유지하는 것이 좋습니다. 그러나 서버를 시작하기 전에 GC_LOG 변수를 false 로 설정하여 독립 실행형 서버에 대해 비활성화할 수 있습니다. 예를 들면 다음과 같습니다.

$ export GC_LOG=false
$ EAP_HOME/bin/standalone.sh
Copy to Clipboard Toggle word wrap

10.1.4. JBoss EAP의 기본 로그 파일 위치

다음 로그 파일은 기본 로깅 구성을 기반으로 생성됩니다. 이러한 구성은 정기 로그 처리기를 사용하여 서버 로그 파일을 작성합니다.

Expand
표 10.1. 독립 실행형 서버의 기본 로그 파일
로그 파일설명

EAP_HOME/standalone/log/server.log

시작 메시지를 포함하여 서버 로그 메시지를 포함합니다.

EAP_HOME/standalone/log/gc.log.DIGIT.current

가비지 컬렉션 세부 정보를 포함합니다.

Expand
표 10.2. 관리형 도메인의 기본 로그 파일
로그 파일설명

EAP_HOME/domain/log/host-controller.log

호스트 컨트롤러 시작과 관련된 로그 메시지를 포함합니다.

EAP_HOME/domain/log/process-controller.log

프로세스 컨트롤러 시작과 관련된 로그 메시지를 포함합니다.

EAP_HOME/domain/servers/SERVER_NAME/log/server.log

시작 메시지를 포함하여 이름이 지정된 서버에 대한 로그 메시지를 포함합니다.

10.1.5. JBoss EAP에서 서버의 기본 로케일 설정

JVM 속성을 시작 구성 파일로 설정하여 JBoss EAP의 기본 로케일을 구성할 수 있습니다. 시작 구성 파일은 독립 실행형 서버의 경우 EAP_HOME/bin/standalone.conf 이거나 관리형 도메인의 EAP_HOME/bin/domain.conf 입니다.

참고

Windows 서버의 경우 JBoss EAP 시작 구성 파일은 standalone.conf.extension 및 domain.conf.extension 입니다.

국제화 및 지역화된 로그 메시지는 이 기본 로케일을 사용합니다.

사전 요구 사항

  • JBoss EAP가 실행 중입니다.
  • 서버 모드의 시작 구성 파일에 액세스할 수 있습니다.

프로세스

  1. user. languageJAVA_OPTS 변수에 추가하여 설정합니다. 예를 들어 로케일을 프랑스어로 설정하려면 시작 구성 파일에 다음 행을 추가합니다.

    JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"
    Copy to Clipboard Toggle word wrap
  2. user. Cryostat 및 user.country 속성을 추가하여 언어 및 국가 설정. 예를 들어 로케일을 브라질 포르투갈어로 설정하려면 다음 행을 추가합니다.

    JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"
    Copy to Clipboard Toggle word wrap
  3. o'rg.jboss.logging.locale' 속성을 사용하여 서버 로케일을 설정하여 로그 메시지에 대해 다른 로케일을 지정합니다. 이렇게 하면 로깅의 기본 로케일이 재정의됩니다. 예를 들어 서버 로케일을 브라질 포르투갈어로 설정하려면 다음 행을 추가합니다.

    JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"
    Copy to Clipboard Toggle word wrap

    이 속성은 JBoss Logging 및 해당 종속 항목을 사용하는 로그 메시지에만 영향을 미칩니다. 자카르타 Server Cryostat와 같은 기타 종속 항목은 재정의된 로케일을 가져올 수 없습니다.

    참고

    시스템 기본값과 다른 로케일로 JBoss EAP를 시작하려면 독립 실행형 모드에서 EAP_HOME/bin/standalone.conf 를 편집하거나 관리형 도메인 모드의 경우 EAP_HOME/bin/domain.conf 를 편집합니다. org.jboss.logging.locale 속성을 사용하여 BCP 47 형식으로 로케일을 설정합니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat
맨 위로 이동