출력 플러그인 매개변수를 통해 IBM Cloud Logs 인스턴스로 데이터를 전송합니다

로깅 에이전트 에서 IBM Cloud Logs 인스턴스로 데이터를 전송하도록 출력 플러그인을 구성하는 데 사용할 수 있는 매개 변수 목록입니다.

FluentBit 매개변수

플루언트비트 매개변수
키 설명 기본 가치 선택 필수
Name 플러그인 이름입니다. logger-icl-output-plugin 로 설정해야 합니다 해당사항 없음 logger-icl-output-plugin 예
Id 플러그인의 고유 ID입니다. 해당사항 없음 임의의 문자열 예
Match 이벤트 매칭 방법을 지정하는 데 사용합니다. 해당사항 없음 임의의 문자열 예
Retry_Limit 플러그인이 클라우드 로그에 데이터를 전송하지 못하면 처리를 다시 시도합니다.
영원히 재시도하려면 False 로 설정하고, 그렇지 않으면 정수 값으로 설정합니다.
재시도를 구성하는 방법에 대한 자세한 내용은 여기에서 확인하세요		 1 False 또는 N >= 1 예
Workers IBM Cloud Logs 전송하는 동시 작업자 스레드의 수입니다.
IBM Cloud Logs 전송되는 로그의 처리량을 늘리려면 각 에이전트에서 전송하는 동시 스레드 수를 늘릴 수 있습니다.
자세한 정보		 1 1 이상 아니오

연결 매개변수

연결 매개변수
키 설명 기본 가치 선택 필수
Target_Host 연결에 사용할 호스트 이름 수집 해당사항 없음 모든 URL 엔드포인트 예
Target_Port 연결에 사용할 수집 포트 443 모든 포트 번호 아니오
Target_Path 연결에 사용할 URL 경로 /logs/v1/singles 임의의 문자열 아니오

로깅 매개변수

로깅 매개변수
키 설명 기본 가치 선택 필수
Logging_Level 플러그인에서 사용할 로그 레벨을 지정합니다 info debug
info
error		 아니오
Package_Size 패키지 크기를 KB 또는 MB 단위로 지정합니다 2 뒤에 단위가 오는 숫자(예: 2MB, 10KB)를 입력합니다. 2MB 보다 작아야 합니다 아니오

인증 매개변수

인증 매개변수
키 설명 기본 가치 선택 필수
Authentication_Mode 인증 모드 지정 TrustedProfile TrustedProfile
IAMAPIKey		 아니오
IAM_Environment 인증을 위한 IAM 환경 지정 Production Production '은 퍼블릭 엔드포인트를 ' iam.cloud.ibm.com '

' PrivateProduction '는 프라이빗 엔드포인트를 ' private.iam.cloud.ibm.com '

' Custom 파라미터 ' IAM_Host'로 지정된 엔드포인트를 지정합니다

 아니오
IAM_Host 사용자 지정 IAM 환경의 IAM 호스트 이름 해당사항 없음 정규화된 IAM 호스트 이름(예: ' private.eu-de.iam.cloud.ibm.com') IAM_Environment 이 다음과 같이 설정된 경우에만 사용됩니다. Custom
CR_Token_Mount_Path CR토큰이 있는 경로 /var/run/secrets/tokens/vault-token 임의의 문자열 false - 인증 모드가 TrustedProfile로 설정된 경우에만 사용됩니다
Trusted_Profile_ID 사용할 신뢰할 수 있는 프로필의 ID 해당사항 없음 임의의 문자열 true - Authentication_Mode가 TrustedProfile으로 설정된 경우에만 사용됩니다
IAM_API_key 사용할 API 키; API 키 지정에 대한 자세한 내용은 아래 참고 사항을 참조하세요 해당사항 없음 임의의 문자열 아니오

Authentication_Mode 이 IAMAPIKey 으로 설정된 경우 API 키는 다음 세 가지 방법 중 하나로 지정해야 합니다. 우선순위에 따라 다음과 같습니다:

  1. 설정에서 IAM_API_key 필드 사용
    • 구성 파일에 API 키를 직접 삽입하지 않는 것이 좋습니다. 대신 ${CUSTOM_ENVIRONMENT_VARIABLE} 형식의 값을 사용하여 아래에 언급된 환경 변수 이외의 환경 변수를 검색할 수 있습니다
  2. 라는 환경 변수를 사용하여 IAM_API_KEY_<output_ID>
    • 여기서 <output_ID> 은 Id 매개변수에 지정된 대로 출력 플러그인에 부여된 ID이며, 대시(-)는 밑줄(_)로 대체됩니다
  3. 라는 환경 변수를 사용하여 IAM_API_KEY

위의 옵션 중 어떤 값도 제공하지 않으면 플러그인 초기화가 실패합니다.

플루언트비트 에이전트 워커 구성 고려 사항

' worker'은 로깅 에이전트 컨텍스트에서 로깅 에이전트 로그를 처리하는 데 사용할 수 있는 CPU 스레드를 나타냅니다.

출력 플러그인 구성에서 사용 가능한 워크맨의 수를 구성할 수 있습니다.

  • 플루언트 비트 기본 구성에서는 ' Workers=1 '이 기본 구성이며, 이는 1MB/sec 미만의 로그 볼륨을 생성하는 워크로드에 적합합니다.
  • 로깅 볼륨이 초당 1MB 이상으로 큰 환경에서는 출력 플러그인이 소비되는 로그를 처리할 수 있도록 ' Workers ' 구성을 늘려야 할 수도 있습니다.
  • ' 오픈시프트 ' 및 ' Kubernetes ' 배포에 대한 ' Helm ' 차트는 일반적으로 대부분의 ' Kubernetes 워크로드에 적합한 설정이므로 4명의 워커로 구성됩니다.

Helm 차트를 사용하는 경우 outputWorkers Helm 변수를 사용하여 출력 플러그인에 대한 작업자 설정을 관리합니다.

사용자 환경에서 ' Workers ' 값을 설정할 때 고려해야 할 몇 가지 사항은 다음과 같습니다:

  • 작업자 수를 4명에서 2명으로 줄이면 로깅 에이전트 CPU 요구 사항이 줄어들 수 있습니다.

  • Kubernetes 환경에서 CPU 제한을 늘리지 않고 작업자 수를 4개 이상으로 늘리면 일반적으로 로깅 에이전트 처리하는 로그가 더 많아지지 않습니다. CPU가 처리량을 제한하고 처리량을 늘려야 하는 시점이 있습니다.

  • 로깅 에이전트 로그에 ' [input] pausing tail 다음에 ' [input] resume tail '를 보고하는 메시지가 표시되면 로그를 전송하는 출력 플러그인이 생성되는 로그의 양을 따라잡을 수 없다는 뜻입니다. CPU 사용량이 정의된 CPU 제한에 도달하지 않은 경우 일반적으로 작업자 수를 늘리면 처리량이 증가합니다. CPU 사용량이 제한에 가까워지면 작업자 수를 늘리는 것 외에도 CPU 제한을 늘려야 할 수 있습니다. ' [input] pausing tail 메시지가 한 시간에 몇 번 발행되더라도 괜찮습니다. 이 메시지가 1분에 여러 번 발생하면 구성 변경을 고려해야 합니다.

  • ' [ warn] [input:tail:tail.0] purged rotated file while data ingestion is paused, consider increasing rotate_wait 이라는 메시지가 표시되면 일반적으로 입력량이 상담원이 처리할 수 있는 것보다 훨씬 빠르다는 뜻입니다. 작업자 수나 CPU(또는 둘 다)를 늘리지 않으면 파일 회전으로 인해 회전된 파일이 더 이상 처리되지 않고 수집이 일시 중지되므로 로그가 누락될 수 있습니다. 이 오류가 발생하면 작업자 또는 CPU 제한(또는 둘 다)을 늘려야 합니다.