VMware Aria Automation 8.16 - Korean - Korea

8.18 8.17 8.16 8.14 8.13 all
Português (Brasil) 简体中文 Deutsch Español Français Italiano 日本語 한국어 Nederlands Русский 繁體中文 English

VMware Aria Automation
에서
VMware Aria Operations for Logs
로 로그 전달을 구성하는 방법

보다 강력한 로그 분석 및 보고서 생성을 활용하기 위해
VMware Aria Automation
에서
VMware Aria Operations for Logs
로 로그를 전달할 수 있습니다.
VMware Aria Automation
에는 fluentd-based 로깅 에이전트가 포함되어 있습니다 . 에이전트는 로그 번들에 포함되고 나중에 검토될 수 있도록 로그를 수집 및 저장합니다. 에이전트는
VMware Aria Operations for Logs
 REST API를 사용하여 로그의 복사본을
VMware Aria Operations for Logs
 서버로 전달할 수 있습니다. API는 기타 프로그램이
VMware Aria Operations for Logs
와 통신하도록 허용합니다.
REST API에 대한 설명서를 포함하여
VMware Aria Operations for Logs
에 대한 자세한 내용은
VMware Aria Operations for Logs
설명서를 참조하십시오.
모든
VMware Aria Automation
 로그를
VMware Aria Operations for Logs
에 전달하려면
vracli
 구성 명령을 사용합니다.
VMware Aria Operations for Logs
에서 각 로그 줄을 검토할 수 있습니다. 각 로그 줄에는 호스트 이름과 환경 태그가 포함되어 있습니다 . HA(고가용성) 환경에서 로그에는 로그가 시작된 노드에 따라 호스트 이름이 다른 태그가 포함됩니다. 환경 태그는
VMware Aria Operations for Logs
의 통합 구성 또는 업데이트
 섹션에 설명된 대로
--environment ENV
 옵션을 사용하여 구성할 수 있습니다. HA(고가용성) 환경에서 환경 태그는 모든 로그 줄에 대해 동일한 값을 갖습니다.
vracli
 명령줄 유틸리티를 사용하는 방법에 대한 정보를 표시하려면
vracli
 명령줄에서
--help
 인수를 사용합니다. 예를 들어
vracli vrli --help
가 표시됩니다. 사용자 친화적인 응답을 위해 명령을
vracli -j vrli
로 시작합니다.
단일 원격 로깅 통합만 구성할 수 있습니다.
VMware Aria Operations for Logs
 서버와
syslog
 서버를 사용할 수 있는 경우
VMware Aria Operations for Logs
에 우선 순위가 있습니다.

VMware Aria Operations for Logs
의 기존 구성 확인

Command
vracli vrli
Arguments
명령줄 인수가 없습니다.
Output
VMware Aria Operations for Logs
 통합에 대한 현재 구성이 JSON 형식으로 출력됩니다.
Exit codes
다음과 같은 종료 코드가 가능합니다.
  • 0 -
    VMware Aria Operations for Logs
    와의 통합이 구성되었습니다.
  • 1 - 예외 오류가 발생했습니다. 자세한 내용은 오류 메시지를 검토하십시오.
  • 61 -
    VMware Aria Operations for Logs
    와의 통합이 구성되지 않았습니다. 자세한 내용은 오류 메시지를 검토하십시오.
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
}

VMware Aria Operations for Logs
의 통합 구성 또는 업데이트

Command
vracli vrli set [options] FQDN_OR_URL
명령을 실행한 후 로깅 에이전트가 지정된 구성을 적용하는 데 약 2분이 소요될 수 있습니다.
Arguments
  • FQDN_OR_URL
    로그를 게시하는 데 사용할
    VMware Aria Operations for Logs
     서버의 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은
    VMware Aria Operations for Logs
     설명서의
    VMware Aria Operations for Logs
     관리
     항목
    포트 및 외부 인터페이스
    에 설명된 것과 같이
    VMware Aria Operations for Logs
     수집 REST API에서 사용됩니다.
  • 옵션
    • --agent-id SOME_ID
      이 장치에 대한 로깅 에이전트의 ID를 설정합니다. 기본값은
      0
      입니다.
      VMware Aria Operations for Logs
       REST API를 사용하여
      VMware Aria Operations for Logs
      에 로그를 게시할 때 에이전트를 식별하는 데 사용됩니다.
    • --environment ENV
      현재 환경에 대한 식별자를 설정합니다.
      VMware Aria Operations for Logs
       로그에서 각 로그 항목에 대한 태그로 사용할 수 있습니다. 기본값은
      prod
      입니다.
    • --ca-file /path/to/server-ca.crt
      VMware Aria Operations for Logs
       서버의 인증서에 서명하는 데 사용된 CA(인증 기관)의 인증서를 포함하는 파일을 지정합니다. 이렇게 하면 로깅 에이전트가 지정된 CA를 신뢰하고
      VMware Aria Operations for Logs
       서버의 인증서를 신뢰할 수 없는 기관에서 서명한 경우 확인할 수 있도록 적용합니다. 이 파일에는 인증서를 확인하는 전체 인증서 체인이 포함될 수 있습니다. 자체 서명된 인증서의 경우 인증서 자체를 전달합니다.
    • --ca-cert CA_CERT
      정의는 위에 있는 --ca-file에 대한 정의와 동일하지만 인증서(체인) 인라인을 문자열로 전달합니다.
    • --insecure
      서버 인증서의 SSL 확인을 비활성화합니다. 로그를 게시할 때 로깅 에이전트가 모든 SSL 인증서를 수락하도록 강제합니다.
  • 고급 옵션
    • --request-max-size BYTES
      단일 API 호출로 여러 로그 이벤트가 수집됩니다. 이 인수는 각 요청에 대한 최대 페이로드 크기(바이트)를 제어합니다. 유효한 값은 4000에서 4000000 사이입니다. 기본값은 256000입니다. 허용되는 값에 대한 관련 정보는
      VMware Aria Operations for Logs
       REST API 설명서에서
      VMware Aria Operations for Logs
       이벤트 수집을 참조하십시오. 이 값을 너무 낮게 설정하면 허용된 크기보다 큰 로깅 이벤트가 삭제될 수 있습니다.
    • --request-timeout SECONDS
      API 호출은 원격 문제, 네트워킹 문제 등 여러 가지 이유로 인해 중단될 수 있습니다. 이 매개 변수는 호출이 실패한 것으로 인식되기 전에 각 작업(예: 연결 열기,데이터 쓰기 또는 응답 대기)이 완료될 때까지 대기하는 시간(초)을 제어합니다. 값은 1초보다 작을 수 없습니다. 기본값은 30입니다.
    • --request-immediate-retries RETRIES
      로그는
      VMware Aria Operations for Logs
      에 전송되기 전에 집계된 청크로 버퍼링됩니다(아래 --buffer-flush-thread-count 참조). API 요청이 실패하면 로그가 즉시 재시도됩니다. 기본 즉시 재시도 횟수는 3입니다. 재시도가 모두 성공하지 않으면 전체 로그 청크가 롤백되고 나중에 다시 시도됩니다.
    • --request-http-compress
      네트워크 트래픽 볼륨을 줄이기 위해
      VMware Aria Operations for Logs
       서버로 전송되는 요청에 gzip 압축을 적용할 수 있습니다. 이 매개 변수를 지정하지 않으면 압축이 사용되지 않습니다.
    • --buffer-flush-thread-count THREADS
      성능을 향상시키고 네트워킹 트래픽을 제한하기 위해 로그는 플러시되어 로그 서버로 전송되기 전에 청크로 로컬에 버퍼링됩니다. 각 청크에는 단일 서비스의 로그가 포함됩니다. 환경에 따라서는 청크가 크게 증가하여 플러시하는 데 시간이 오래 걸릴 수 있습니다. 이 인수는 동시에 플러시할 수 있는 청크 수를 제어합니다. 기본값은 2입니다.
https를 통한 통합을 구성할 때
VMware Aria Operations for Logs
 서버가 신뢰할 수 없는 인증서(예: 자체 서명된 인증서 또는 신뢰할 수 없는 기관에서 서명한 인증서)를 사용하도록 구성된 경우,
--ca-file
,
--ca-cert
 또는
--insecure
 옵션 중 하나를 사용해야 합니다. 그렇지 않으면 로깅 에이전트가 서버 ID의 유효성을 검사하지 못하고 로그를 보내지 않습니다.
--ca-file
 또는
--ca-cert
를 사용하는 경우
VMware Aria Operations for Logs
 서버 인증서가 서버의 호스트 이름에 대해 유효해야 합니다. 모든 경우, 처리를 위해 몇 분을 기다린 후
VMware Aria Operations for Logs
가 로그를 받았는지 확인하여 통합을 확인합니다.
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

VMware Aria Operations for Logs
의 통합 지우기

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

Content feedback and comments