더욱 강력한 로그 분석 및 보고서 생성을 활용하기 위해 vRealize Automation에서 vRealize Log Insight로 로그를 전달할 수 있습니다.

vRealize Automationfluentd-based 로깅 에이전트와 함께 번들로 구성됩니다. 에이전트는 로그 번들에 포함되고 나중에 검토될 수 있도록 로그를 수집 및 저장합니다. vRealize Log Insight REST API를 사용하여 로그의 복사본을 vRealize Log Insight 서버로 전달하도록 에이전트를 구성할 수 있습니다. API는 기타 프로그램이 vRealize Log Insight와 통신하도록 허용합니다.

vRealize Log Insight REST API에 대한 설명서를 포함하여 vRealize Log Insight에 대한 자세한 내용은 vRealize Log Insight 설명서를 참조하십시오.

제공된 vracli 명령줄 유틸리티를 사용하여 vRealize Automation 로그를 vRealize Log Insight로 지속적으로 전달하도록 로깅 에이전트를 구성합니다.

모든 로그 줄에는 호스트 이름 및 환경 태그가 지정되어 있기 때문에 vRealize Log Insight에서 검사할 수 있습니다. HA(고가용성) 환경에서 로그에는 로그가 시작된 노드에 따라 서로 다른 호스트 이름으로 태그가 지정됩니다. 환경 태그는 아래의 "vRealize Log Insight 통합 구성 또는 업데이트" 섹션에 설명된 대로 --environment ENV 옵션을 사용하여 구성할 수 있습니다. HA 환경에서 환경 태그는 로그가 시작된 노드에 관계없이 모든 로그 줄에 대해 동일한 값을 가집니다.

vracli 명령줄 유틸리티를 사용하는 방법에 대한 정보는 vracli 명령줄에서 --help 인수를 사용하여 확인할 수 있습니다. 예: vracli vrli --help. 사용자 친화적인 응답을 위해 명령을 vracli -j vrli로 시작합니다.

참고: 단일 원격 로깅 통합만 구성할 수 있습니다. vRealize Log Insight 서버와 Syslog 서버를 둘 다 사용할 수 있는 경우 vRealize Log Insight에 우선 순위가 지정됩니다.

vRealize Log Insight의 기존 구성 확인

Command

vracli vrli

Arguments

명령줄 인수가 없습니다.

Output

vRealize Log Insight 통합에 대한 현재 구성이 JSON 형식으로 출력됩니다.

Exit codes
다음과 같은 종료 코드가 가능합니다.
  • 0 - vRealize Log Insight와의 통합이 구성되었습니다.
  • 1 - 명령 실행의 일부로 예외가 발생했습니다. 자세한 내용은 오류 메시지를 검토하십시오.
  • 61(ENODATA) - vRealize Log Insight와의 통합이 구성되지 않았습니다. 자세한 내용은 오류 메시지를 검토하십시오.
Example - check integration configuration
$ vracli vrli
No vRLI integration configured
 
$ vracli vrli
{
    "agentId": "0",
    "environment": "prod",
    "host": "my-vrli.local",
    "port": 9543,
    "scheme": "https",
    "sslVerify": false
}

vRealize Log Insight의 통합 구성 또는 업데이트

Command

vracli vrli set [options] FQDN_OR_URL

참고: 명령을 실행한 후 로깅 에이전트가 지정된 구성을 적용하는 데 약 2분이 소요될 수 있습니다.
Arguments
  • FQDN_OR_URL

    로그를 게시하는 데 사용할 vRealize Log Insight 서버의 FQDN 또는 URL 주소를 지정합니다. 기본적으로 포트 9543 및 HTTPS가 사용됩니다. 이러한 설정 중 하나를 변경해야 하는 경우 URL을 대신 사용할 수 있습니다.

    vracli vrli set <options> https://FQDN:9543
    참고:
    다음 샘플에 표시된 것과 같이 로그를 전송하는 데 사용할 서로 다른 호스트 체계(기본값: https) 및 포트(https의 기본값은 9543, http의 기본값은 9000)를 설정할 수 있습니다.
    vracli vrli set https://HOSTNAME:9543
    vracli vrli set --insecure HOSTNAME
    vracli vrli set http://HOSTNAME:9000

    https용 포트 9543 및 http용 포트 9000은 vRealize Log Insight 설명서의 "vRealize Log Insight 관리" 항목 "포트 및 외부 인터페이스" 에 설명된 것과 같이 vRealize Log Insight 수집 REST API에서 사용됩니다.

  • 옵션
    • --agent-id SOME_ID

      이 장치에 대한 로깅 에이전트의 ID를 설정합니다. 기본값은 0입니다. vRealize Log Insight REST API를 사용하여 vRealize Log Insight에 로그를 게시할 때 에이전트를 식별하는 데 사용됩니다.

    • --environment ENV

      현재 환경에 대한 식별자를 설정합니다. vRealize Log Insight 로그에서 각 로그 항목에 대한 태그로 사용할 수 있습니다. 기본값은 prod입니다.

    • --ca-file /path/to/server-ca.crt

      vRealize Log Insight 서버의 인증서에 서명하는 데 사용된 CA(인증 기관)의 인증서를 포함하는 파일을 지정합니다. 이렇게 하면 로깅 에이전트가 지정된 CA를 신뢰하고 vRealize Log Insight 서버의 인증서를 신뢰할 수 없는 기관에서 서명한 경우 확인할 수 있도록 적용합니다. 이 파일에는 인증서를 확인하는 전체 인증서 체인이 포함될 수 있습니다. 자체 서명된 인증서의 경우 인증서 자체를 전달합니다.

    • --ca-cert CA_CERT

      정의는 위에 있는 --ca-file에 대한 정의와 동일하지만 인증서(체인) 인라인을 문자열로 전달합니다.

    • --insecure

      서버 인증서의 SSL 확인을 비활성화합니다. 로그를 게시할 때 로깅 에이전트가 모든 SSL 인증서를 수락하도록 강제합니다.

  • 고급 옵션
    • --request-max-size BYTES

      단일 API 호출로 여러 로그 이벤트가 수집됩니다. 이 인수는 각 요청에 대한 최대 페이로드 크기(바이트)를 제어합니다. 유효한 값은 4000에서 4000000 사이입니다. 기본값은 256000입니다. 허용되는 값에 대한 관련 정보는 vRealize Log Insight REST API 설명서에서 vRealize Log Insight 이벤트 수집을 참조하십시오. 이 값을 너무 낮게 설정하면 허용된 크기보다 큰 로깅 이벤트가 삭제될 수 있습니다.

    • --request-timeout SECONDS

      API 호출은 원격 문제, 네트워킹 문제 등 여러 가지 이유로 인해 중단될 수 있습니다. 이 매개 변수는 호출이 실패한 것으로 인식되기 전에 각 작업(예: 연결 열기,데이터 쓰기 또는 응답 대기)이 완료될 때까지 대기하는 시간(초)을 제어합니다. 값은 1초보다 작을 수 없습니다. 기본값은 30입니다.

    • --request-immediate-retries RETRIES

      로그는 vRealize Log Insight에 전송되기 전에 집계된 청크로 버퍼링됩니다(아래 --buffer-flush-thread-count 참조). API 요청이 실패하면 로그가 즉시 재시도됩니다. 기본 즉시 재시도 횟수는 3입니다. 재시도가 모두 성공하지 않으면 전체 로그 청크가 롤백되고 나중에 다시 시도됩니다.

    • --request-http-compress

      네트워크 트래픽 볼륨을 줄이기 위해 vRealize Log Insight 서버로 전송되는 요청에 gzip 압축을 적용할 수 있습니다. 이 매개 변수를 지정하지 않으면 압축이 사용되지 않습니다.

    • --buffer-flush-thread-count THREADS

      성능을 향상시키고 네트워킹 트래픽을 제한하기 위해 로그는 플러시되어 로그 서버로 전송되기 전에 청크로 로컬에 버퍼링됩니다. 각 청크에는 단일 서비스의 로그가 포함됩니다. 환경에 따라서는 청크가 크게 증가하여 플러시하는 데 시간이 오래 걸릴 수 있습니다. 이 인수는 동시에 플러시할 수 있는 청크 수를 제어합니다. 기본값은 2입니다.

참고:

https를 통한 통합을 구성할 때 vRealize Log Insight 서버가 신뢰할 수 없는 인증서(예: 자체 서명된 인증서 또는 신뢰할 수 없는 기관에서 서명한 인증서)를 사용하도록 구성된 경우, --ca-file, --ca-cert 또는 --insecure 옵션 중 하나를 사용해야 합니다. 그렇지 않으면 로깅 에이전트가 서버 ID의 유효성을 검사하지 못하고 로그를 보내지 않습니다. --ca-file 또는 --ca-cert를 사용하는 경우 vRealize Log Insight 서버 인증서가 서버의 호스트 이름에 대해 유효해야 합니다. 모든 경우, 처리를 위해 몇 분을 기다린 후 vRealize Log Insight가 로그를 받았는지 확인하여 통합을 확인합니다.

Output

출력이 예상되지 않습니다.

Exit codes
다음과 같은 종료 코드가 가능합니다.
  • 0 - 구성이 업데이트되었습니다.
  • 1 - 실행의 일부로 예외가 발생했습니다. 자세한 내용은 오류 메시지를 검토하십시오.
Examples - Configure or update integration configuration
다음 예제 문은 별도의 명령줄에 표시되지만 인수를 단일 명령줄로 결합할 수 있습니다. 예를 들어 vracli vrli set {somehost} 또는 vracli vrli set --ca-file path/to/server-ca.crt를 사용하여 기본 에이전트 ID 또는 환경 값을 수정할 때 여러 인수를 포함할 수 있습니다. 관련 정보는 vracli vrli --help에서 온라인 명령 도움말을 참조하십시오.
$ vracli vrli set my-vrli.local 
$ vracli vrli set 10.20.30.40
$ vracli vrli set --ca-file /etc/ssl/certs/ca.crt 10.20.30.40
$ vracli vrli set --ca-cert "$(cat /etc/ssl/certs/ca.crt)" 10.20.30.40
$ vracli vrli set --insecure http://my-vrli.local:8080
$ vracli vrli set --agent-id my-vrli-agent my-vrli.local
$ vracli vrli set --request-http-compress
$ vracli vrli set --environment staging my-vrli.local
$ vracli vrli set --environment staging --request-max-size 10000 --request-timeout 120 --request-immediate-retries 5 --buffer-flush-thread-count 4 my-vrli.local

vRealize Log Insight의 통합 지우기

Command

vracli vrli unset

참고: 명령을 실행한 후 로깅 에이전트가 지정된 구성을 적용하는 데 약 2분이 소요될 수 있습니다.
Arguments

명령줄 인수가 없습니다.

Output

확인이 일반 텍스트 형식으로 출력됩니다.

Exit codes
다음과 같은 종료 코드를 사용할 수 있습니다.
  • 0 - 구성이 지워졌거나 구성이 없습니다.
  • 1 - 실행의 일부로 예외가 발생했습니다. 자세한 내용은 오류 메시지를 검토하십시오.
Examples - Clear integration
$ vracli vrli unset
Clearing vRLI integration configuration
 
$ vracli vrli unset
No vRLI integration configured