linux-env
리눅스 시스템의 환경 변수 목록을 조회합니다. 로그프레소 프로세스에 설정된 환경 변수의 이름과 값을 확인할 수 있습니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 수집 노드에서 실행 (mapper) |
문법
linux-env
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
name | 문자열 | 환경 변수 이름 |
value | 문자열 | 환경 변수 값 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 95040 | no-read-permission | 관리자 권한 없이 실행한 경우 발생 |
런타임 오류
해당 사항 없음
설명
linux-env 명령어는 JVM의 System.getenv()를 호출하여 로그프레소 프로세스에 설정된 환경 변수를 조회합니다. 각 환경 변수에 대해 name과 value 필드를 포함하는 레코드를 반환합니다.
환경 변수에는 파일 시스템 경로, 사용자 정보 등 시스템 구성과 관련된 정보가 포함될 수 있으므로 관리자 권한이 필요합니다.
이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.
사용 예
각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.
-
환경 변수 전체 조회
linux-env로그프레소 프로세스에 설정된 모든 환경 변수를 조회합니다.
-
특정 환경 변수 검색
linux-env | search name == "PATH"PATH환경 변수의 값을 조회합니다. -
환경 변수 이름으로 정렬
linux-env | sort name환경 변수를 이름 기준으로 정렬하여 조회합니다.
호환성
linux-env 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.