중앙 로그 설정
Bahmni는 여러 컨테이너의 로그를 하나의 UI에서 시각화하는 중앙 로그를 지원합니다. 중앙 로그는 PLG(Promtail, Loki, Grafana) 스택으로 설정됩니다. Bahmni가 Docker 컨테이너에서 실행되므로 주로 Loki와 Grafana를 사용하며 시스템 로그까지 수집하려면 Promtail을 사용할 수 있습니다.
1. Loki Logging Driver 설치
Loki 스택은 컨테이너 로그를 가져와 Loki로 보내기 위해 Loki Docker Driver Client를 사용합니다. 안내된 명령을 실행하여 드라이버를 설치하거나 관련 문서를 참고하십시오.
참고: Bahmni 애플리케이션 서버와 모니터링 서버 양쪽에 이 플러그인을 설치해야 합니다.
2. docker-compose.yml의 로그 방식 수정
docker-compose 기본 설정은 Docker daemon에 설정된 기본 로그 방식을 사용합니다.
서비스의 Loki 로깅을 활성화하려면 bahmni-lite 또는 bahmni-standard 폴더의 docker-compose 파일에서 x-log-config 섹션을 찾아 값을 *default에서 *loki로 변경합니다.
참고: bahmni-docker와 bahmni-observability 저장소 양쪽의 docker-compose.yml 파일을 모두 수정하십시오.
3. Loki URL 수정
bahmni-docker/bahmni-lite 또는 bahmni-docker/bahmni-standard 디렉터리의 .env 파일에 Loki 인스턴스 위치와 로그 전송 대상을 결정하는 LOKI_URL 변수가 있습니다.
같은 컴퓨터에서 Loki 스택을 실행하면 http://localhost:3100/loki/api/v1/push 를 변수 값으로 사용합니다.
외부 서버에서 Loki 스택을 실행하면 http://<ip>:3100/loki/api/v1/push 를 변수 값으로 사용합니다.
4. Loki 스택 서비스 시작
1단계: bahmni-observability 저장소를 복제합니다.
2단계: .env 파일의 COMPOSE_PROFILES에 logging 프로필을 추가합니다.
이제 bahmni-observability 디렉터리에서 명령을 실행하여 Loki 스택 서비스를 시작할 수 있습니다.
5. 로그 보기
- 1. http://localhost:81 또는 https://localhost:445 로 이동하여 사용자 이름과 비밀번호 모두 admin으로 로그인한 뒤 비밀번호를 변경합니다.
- 2. Grafana 왼쪽 패널에서 Explore 아이콘을 선택합니다.
- 3. Log Browser에서 레이블을 compose_service로 지정하고 필요한 컨테이너 값을 선택한 뒤 화면 오른쪽 위의 Run Query를 누르면 현재 로그가 표시됩니다.
- 4. 오른쪽 위의 Live를 눌러 실시간 로그 스트림을 볼 수도 있습니다.
6. Loki 설정
Loki는 YAML 파일 형식의 여러 설정을 지원하며 loki-config.yaml에 추가할 수 있습니다.
i. 로그 보존
중앙 로그 스택의 기본 보존 기간은 24시간이며 요구사항에 맞게 바꿀 수 있습니다. loki-config.yaml의 retention_period 설정을 찾아 최소 24h 이상의 값으로 수정합니다.
예시
설정 파일을 수정한 뒤 docker compose restart loki 명령으로 Loki 컨테이너를 다시 시작합니다.
Bahmni Wiki · CC BY-SA 4.0