카테고리 없음

💡 [CentOS/RHEL 8] Fluent Bit(td-agent-bit) 설치 및 libpq.so.5 오류 해결 방법

idea9329 2025. 4. 7. 15:30
반응형

 

📌 키워드:

td-agent-bit 설치, Fluent Bit CentOS 8, libpq.so.5 오류, PostgreSQL 라이브러리, Fluent Bit log 수집, td-agent-bit rpm, libpq.so.5(RHPG_9.6) 해결


✅ 1. td-agent-bit 설치 중 오류 발생

CentOS/RHEL 8 환경에서 td-agent-bit 설치를 시도하면 다음과 같은 에러를 만날 수 있습니다:

Error:
  - nothing provides libpq.so.5()(64bit)
  - nothing provides libpq.so.5(RHPG_9.6)(64bit)

이는 td-agent-bit가 PostgreSQL 클라이언트 라이브러리인 libpq.so.5를 필요로 하지만, 시스템에 해당 라이브러리가 설치되지 않아 발생하는 문제입니다.


✅ 2. PostgreSQL 공식 리포지토리 추가 및 라이브러리 설치

🔹 PostgreSQL 14 리포지토리 추가

sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo dnf module disable -y postgresql

🔹 PostgreSQL 라이브러리 설치

sudo dnf install -y postgresql14-libs

설치 후에도 /usr/lib64/libpq.so.5 경로에 라이브러리가 없을 수 있습니다.
실제 위치는 다음과 같습니다:

/usr/pgsql-14/lib/libpq.so.5

✅ 3. 심볼릭 링크로 경로 문제 해결

td-agent-bit는 /usr/lib64/libpq.so.5 경로를 기대하기 때문에, 아래와 같이 링크를 생성해 줍니다:

sudo ln -s /usr/pgsql-14/lib/libpq.so.5 /usr/lib64/libpq.so.5
sudo ldconfig

✅ 4. td-agent-bit 설치 진행

sudo dnf install -y td-agent-bit

설치 후 다음 명령으로 실행 확인:

/opt/td-agent-bit/bin/td-agent-bit --version

⚠️ 참고: libpq.so.5 version information warning

/usr/pgsql-14/lib/libpq.so.5: no version information available (required by td-agent-bit)

이 메시지는 PostgreSQL 심볼 버전이 누락된 경고일 뿐, 실행과 기능에는 영향 없습니다.


✅ 5. 명령어를 전역으로 사용하기

sudo ln -s /opt/td-agent-bit/bin/td-agent-bit /usr/local/bin/td-agent-bit

이후 어디서든 아래처럼 사용 가능:

td-agent-bit --version

✅ 마무리

이제 td-agent-bit가 정상 실행되고, log 수집 및 출력 설정만 하면 됩니다.
다음에는 Fluent Bit 설정 파일을 작성하여 /var/log/secure 등의 로그를 stdout이나 CloudWatch로 전송하는 방법을 다룰 예정입니다.


📎 요약

항목설명

문제 libpq.so.5 관련 의존성 오류
원인 PostgreSQL 라이브러리 미설치 또는 경로 불일치
해결 PostgreSQL 14 설치 + 심볼릭 링크 생성
확인 td-agent-bit --version 정상 출력
참고 경고 메시지는 무시 가능



반응형