sentry-logger-deploy

센트리에 로거 프로비저닝 프로파일에 정의된 로거 집합을 일괄 생성합니다.

문법

sentry-logger-deploy

설명

로그프레소는 클라우드에서 동적으로 생성되는 인스턴스의 로그를 수집할 수 있도록, 센트리 접속 시 로거를 자동으로 설정하는 로거 프로비저닝 프로파일 기능을 지원합니다. 하지만 접속 시 로거 프로비저닝을 자동으로 실행하려면, 센트리를 시작할 때 환경 변수 logpresso.sentry.logger_provisioning_profile를 지정해야 합니다. 이 명령어는 로그프레소 센트리 부팅 시 로거 프로비저닝 프로파일을 지정하지 않더라도 특정 로거 프로비저닝 프로파일에서 정의한 로거 집합을 지정한 로그프레소 센트리에 자동으로 구성합니다.

이 명령어는 프로비저닝 시작 요청만 전달하고 대기하지 않으므로 명령어가 종료된 시점에도 로거 구성은 대기 중이거나 처리 중일 수 있습니다. 또한 로거 프로비저닝을 실행하던 중에 실패하더라도 시스템 로그 기록 외에 별도로 통지되지 않습니다.

Tip
로그프레소 셸에서 logpresso.loggerProvisioningTasks 명령으로 대기 중인 로거 프로비저닝 태스크 수를 확인할 수 있습니다.
입력 필드

이 명령어는 입력 레코드에 guid, profile_guid 필드 값이 필요합니다.

필드타입설명
guid문자열센트리 고유 식별자(자바 GUID 형식과 무관)
profile_guid문자열로거 프로비저닝 프로파일 식별자(32자 GUID 형식)
출력 필드

이 명령어는 오류가 발생하면 원본 레코드의 필드에 _error 필드를 추가하여 출력합니다. 발생할 수 있는 오류는 아래와 같습니다:

오류 메시지의미
guid is null입력 레코드의 guid 필드 값이 null
guid should be string입력 레코드의 guid 필드 값이 문자열이 아님
guid should be non empty string입력 레코드의 guid 필드 값이 빈 문자열임
profile_guid is null입력 레코드의 profile_guid 필드 값이 null
profile_guid should be string입력 레코드의 profile_guid 필드 값이 문자열이 아님
profile_guid should be non empty string입력 레코드의 profile_guid 필드 값이 빈 문자열임
not connected지정된 센트리가 접속된 상태가 아님
profile not found: profile_guid지정된 로거 프로비저닝 프로파일이 존재하지 않음

사용 예

윈도우 센트리를 대상으로 윈도우 로거 자동 구성 명령

sentry
| search os == "Windows*"
| eval profile_guid="448c0422-7a30-42ef-b73a-e855e538f779"
| sentry-logger-deploy