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파일에 액세스할 수 있습니다.
프로세스
-
파일 뷰어에서
server.log파일을 엽니다. - 파일의 끝으로 이동합니다.
-
최신 부팅 순서의 시작을 나타내는
WFLYSRV0049메시지 식별자가 뒤로 검색됩니다. 해당 시점부터
ERROR인스턴스의 로그를 검색합니다. 각 인스턴스에는 오류에 대한 설명이 포함되어 있으며 관련 모듈을 나열합니다.다음은
server.log로그 파일의 오류 설명 예입니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.1.2.1.2. 관리 CLI 명령을 사용하여 부팅 오류 읽기 링크 복사링크가 클립보드에 복사되었습니다!
JBoss EAP 문제를 해결할 때 read-boot-errors 관리 CLI 명령을 사용하여 부팅 중에 보고된 오류를 볼 수 있습니다.
이 방법은 서버의 파일 시스템에 액세스할 수 없으므로 스크립팅을 통해 원격 모니터링 및 오류 검사를 활성화합니다. 관리 CLI 명령을 사용하면 부팅 오류를 식별하고 해결할 수 있습니다. 예를 들어 여러 JBoss EAP 인스턴스를 시작하고 부팅 오류를 확인하는 스크립트를 작성할 수 있습니다.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
관리 CLI를 시작합니다.
<EAP_HOME>/bin/jboss-cli.sh
$ <EAP_HOME>/bin/jboss-cli.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 관리 CLI 명령을 실행합니다.
/core-service=management:read-boot-errors
/core-service=management:read-boot-errorsCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력을 검토하여 부팅 중에 발생한 오류 목록을 확인합니다.
- 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
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
$ export GC_LOG=false
$ EAP_HOME/bin/standalone.sh
10.1.4. JBoss EAP의 기본 로그 파일 위치 링크 복사링크가 클립보드에 복사되었습니다!
다음 로그 파일은 기본 로깅 구성을 기반으로 생성됩니다. 이러한 구성은 정기 로그 처리기를 사용하여 서버 로그 파일을 작성합니다.
| 로그 파일 | 설명 |
|---|---|
|
| 시작 메시지를 포함하여 서버 로그 메시지를 포함합니다. |
|
| 가비지 컬렉션 세부 정보를 포함합니다. |
| 로그 파일 | 설명 |
|---|---|
|
| 호스트 컨트롤러 시작과 관련된 로그 메시지를 포함합니다. |
|
| 프로세스 컨트롤러 시작과 관련된 로그 메시지를 포함합니다. |
|
| 시작 메시지를 포함하여 이름이 지정된 서버에 대한 로그 메시지를 포함합니다. |
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가 실행 중입니다.
- 서버 모드의 시작 구성 파일에 액세스할 수 있습니다.
프로세스
user. language를JAVA_OPTS변수에 추가하여 설정합니다. 예를 들어 로케일을 프랑스어로 설정하려면 시작 구성 파일에 다음 행을 추가합니다.JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"
JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"Copy to Clipboard Copied! Toggle word wrap Toggle overflow user. Cryostat 및
및 국가 설정. 예를 들어 로케일을 브라질 포르투갈어로 설정하려면 다음 행을 추가합니다.user.country속성을 추가하여 언어JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"
JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"Copy to Clipboard Copied! Toggle word wrap Toggle overflow o'rg.jboss.logging.locale' 속성을 사용하여 서버 로케일을 설정하여 로그 메시지에 대해 다른 로케일을 지정합니다. 이렇게 하면 로깅의 기본 로케일이 재정의됩니다. 예를 들어 서버 로케일을 브라질 포르투갈어로 설정하려면 다음 행을 추가합니다.
JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"
JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 속성은 JBoss Logging 및 해당 종속 항목을 사용하는 로그 메시지에만 영향을 미칩니다. 자카르타 Server Cryostat와 같은 기타 종속 항목은 재정의된 로케일을 가져올 수 없습니다.
참고시스템 기본값과 다른 로케일로 JBoss EAP를 시작하려면 독립 실행형 모드에서
EAP_HOME/bin/standalone.conf를 편집하거나 관리형 도메인 모드의 경우EAP_HOME/bin/domain.conf를 편집합니다.org.jboss.logging.locale속성을 사용하여 BCP 47 형식으로 로케일을 설정합니다.