이벤트 정책 파일 아카이빙
요약 사전 정의된 아카이브 사이트에 관련 파일을 업로드하도록 이벤트 정책을 구성합니다.
이벤트 정책 파일 아카이빙 개요
다양한 유형의 파일이 이벤트를 진단하고 네트워크 문제를 해결하는 데 유용합니다. 이벤트 정책 작업에서 출력 파일을 생성하면 나중에 분석할 수 있도록 파일을 보관할 수 있습니다. 마찬가지로 이벤트 발생 시점부터 시스템 로그 파일, 코어 파일 및 구성 파일을 포함한 시스템 파일을 보관할 수 있습니다.
이벤트가 발생하면 분석을 위해 관련 파일을 지정된 위치에 업로드할 수 있습니다. 이벤트 정책에서 파일을 아카이브하려면 파일이 업로드되는 아카이브 사이트를 지정하는 하나 이상의 대상을 구성합니다. 그런 다음 이벤트 정책 내에서 구성된 대상을 참조합니다. 이벤트 정책이 트리거되면 지정된 보관 사이트에 파일을 업로드합니다.
이벤트 정책 아카이브 작업에 대한 전송 지연을 구성할 수 있습니다. 전송 지연을 사용하면 하나 이상의 파일을 업로드하기 전에 이벤트 프로세스(eventd)가 대기하는 시간(초)을 지정할 수 있습니다. 전송 지연은 업로드가 시작되기 전에 코어 파일과 같은 대용량 파일이 완전히 생성되도록 하는 데 도움이 됩니다.
전송 지연을 대상 및 이벤트 정책 작업과 연결할 수 있습니다. 전송 지연을 대상과 연결하면 해당 대상을 사용하는 모든 파일 업로드 작업에 전송 지연이 적용됩니다. 이벤트 정책 작업에 전송 지연을 할당할 수도 있습니다. 예를 들어, 동일한 대상을 사용하는 여러 이벤트 정책 작업이 있을 수 있으며, 이러한 이벤트 정책 작업 중 일부의 경우 전송 지연을 원하고 다른 이벤트 정책 작업의 경우 전송 지연을 원하지 않을 수 있습니다. 대상에 대한 전송 지연을 구성하고 이벤트 정책 작업에 대한 전송 지연도 구성하는 경우, 결과 전송 지연은 두 지연의 합계입니다.
일시적인 네트워크 문제로 인해 파일 업로드 작업이 실패할 수 있습니다. 어떤 이유로든 업로드가 실패하는 경우 기본적으로 이벤트 정책은 업로드를 다시 시도하지 않습니다. 그러나 초기 업로드가 실패할 경우 지정된 횟수만큼 파일 업로드 작업을 재시도하도록 이벤트 정책을 구성할 수 있습니다. 각 재시도 사이의 시간 간격을 구성할 수도 있습니다.
이벤트 정책 파일 아카이빙을 위한 대상 정의
이벤트가 발생하면 분석을 위해 관련 파일을 지정된 위치에 업로드할 수 있습니다. 이벤트 정책에서 파일을 보관하려면 먼저 파일이 업로드되는 보관 사이트를 지정하는 대상을 하나 이상 구성해야 합니다. 그런 다음 이벤트 정책 내에서 구성된 대상을 참조합니다.
대상 보관 사이트를 정의하려면 계층 수준에서 문을 [edit event-options] 포함합니다destinations.
[edit event-options]
destinations {
destination-name {
archive-sites {
url <password password>;
}
transfer-delay seconds;
}
}
각 대상에 대해 파일이 업로드되는 실제 사이트인 보관 사이트 URI를 하나 이상 구성합니다. 지정된 대상에 대해 여러 아카이브 사이트 URI를 지정하는 경우 디바이스는 목록의 첫 번째 아카이브 사이트로 파일을 전송하려고 시도하고 이전 사이트로의 전송이 실패하는 경우 후속 아카이브 사이트만 사용합니다. 보관 사이트에 로그인하기 위해 인증이 필요한 경우 해당 사이트에 대한 일반 텍스트 비밀번호를 구성할 수 있습니다. 디바이스는 구성 데이터베이스에 암호화된 값으로 암호를 저장합니다.
아카이브 사이트 URI는 파일 URI, 활성 또는 수동 FTP URI, SFTP(보안 FTP) URI 또는 SCP(보안 사본) URI입니다. 로컬 디바이스 디렉터리(예: /var/tmp)도 지원됩니다. 보관 사이트 URI를 지정할 때 URI 끝에 슬래시(/)를 추가하지 마십시오.
-
파일:<//host>/path
-
ftp://username@host:<port>url-path
-
pasvftp://username@host:<port>url-path
-
sftp://username@host:<port>url-path
-
scp://username@host:<port>url-path
-
<path>/<filename>
각 대상에 대한 전송 지연을 정의할 수도 있습니다. 전송 지연은 하나 이상의 파일을 해당 대상에 업로드하기 전에 이벤트 프로세스(eventd)가 대기하는 시간(초)입니다. 전송 지연은 업로드가 시작되기 전에 코어 파일과 같은 대용량 파일이 완전히 생성되도록 하는 데 도움이 됩니다.
이벤트 정책에서 파일을 업로드할 수 있는 대상 보관 사이트를 정의하려면:
파일을 업로드하도록 이벤트 정책 구성
기존 시스템 파일을 업로드하거나 이벤트 발생 시 호출된 이벤트 스크립트 또는 운영 명령에서 생성된 출력 파일을 업로드하도록 이벤트 정책을 구성할 수 있습니다. 디바이스는 해당 이벤트 정책 작업에 대해 구성된 문에서 참조되는 destination 위치에 파일을 업로드합니다. 계층 수준에서 구성된 [edit event-options destinations] 대상 이름을 지정해야 합니다.
다음 예제에서는 특정 파일을 기존 대상에 업로드하도록 다양한 이벤트 정책 작업을 구성합니다. 또한 각 이벤트 정책에 대해 적절한 이벤트를 구성하고 다른 필수 명령문을 포함해야 합니다.
시스템 파일 업로드
구성된 대상에 시스템 파일을 업로드하도록 이벤트 정책을 구성하려면,
-
upload이벤트 정책 작업을 구성하고 업로드할 파일과 대상 사이트를 지정합니다.여러
upload문을 포함할 수 있으며, 문은filename파일 이름 globbing 을 사용하여 여러 파일을 지정할 수 있습니다.[edit event-options policy policy-name then] user@host# set upload filename (filename | committed) destination destination-name
다음 이벤트 정책 작업은 커밋된 구성 파일을 업로드하고 /var/log 디렉터리에 있고 문자열 "messages"로 시작하는 모든 파일도 업로드합니다.
[edit event-options policy policy1 then] user@host# set upload filename committed destination mgmt-archives user@host# set upload filename /var/log/messages* destination mgmt-archives
- (선택 사항) 파일 업로드 전 지연 구성 및 파일 업로드 작업을 재시도하도록 이벤트 정책 구성에 설명된 대로 전송 지연 또는 재시도 옵션을 구성합니다
명령 출력 파일 업로드
이벤트 정책에는 이벤트에 대한 응답으로 명령을 실행하고 명령 출력을 파일에 기록하는 이벤트 정책 작업이 포함될 execute-commands 수 있습니다. 명령 출력 파일을 구성된 대상에 업로드하도록 이벤트 정책을 구성하려면,
-
execute-commands이벤트 정책 작업에서 대상을 구성합니다.[edit event-options policy policy-name then] user@host# set execute-commands destination destination-name
예를 들어:
[edit event-options policy policy1 then] user@host# set execute-commands destination mgmt-archives
-
출력 파일의 파일 이름에 포함될 설명 문자열을 정의합니다.
[edit event-options policy policy-name then] user@host# set execute-commands output-filename string
예를 들어:
[edit event-options policy policy1 then] user@host# set execute-commands output-filename intf-info
- (선택 사항) 파일 업로드 전 지연 구성 및 파일 업로드 작업을 재시도하도록 이벤트 정책 구성에 설명된 대로 전송 지연 또는 재시도 옵션을 구성합니다
이벤트 스크립트 출력 파일 업로드
이벤트 정책이 이벤트에 대한 응답으로 이벤트 스크립트를 실행하면 이벤트 스크립트는 파일에 출력을 쓸 수 있습니다. 생성된 출력 파일을 구성된 대상에 업로드하도록 이벤트 정책을 구성하려면,
-
event-script이벤트 정책 작업에서 대상을 구성합니다.[edit event-options policy policy-name then] user@host# set event-script filename destination destination-name
예를 들어:
[edit event-options policy policy1 then] user@host# set event-script get-intf-info destination mgmt-archives
-
출력 파일의 파일 이름에 포함될 설명 문자열을 정의합니다.
[edit event-options policy policy-name then] user@host# set event-script filename output-filename string
예를 들어:
[edit event-options policy policy1 then] user@host# set event-script get-intf-info output-filename intf-info
- (선택 사항) 파일 업로드 전 지연 구성 및 파일 업로드 작업을 재시도하도록 이벤트 정책 구성에 설명된 대로 전송 지연 또는 재시도 옵션을 구성합니다
업로드된 파일의 파일 이름
이벤트 정책 작업이 파일을 업로드할 때 업로드된 각 파일의 파일 이름에는 고유함을 보장하기 위해 호스트 이름과 타임스탬프가 포함됩니다. 파일 이름은 Junos OS 소프트웨어 버전에 따라 다릅니다. Junos OS 릴리스 14.1R3부터 파일 이름은 다음과 같은 명명 규칙을 갖습니다.
hostname_YYYYMMDD_HHMMSS_output-filename_index-number
이전 릴리스에서는 파일 이름에 다음과 같은 명명 규칙이 있습니다.
hostname_output-filename_YYYYMMDD_HHMMSS_index-number
문자열은 output-filename 기존 파일의 이름이거나 해당 이벤트 정책 작업에 대해 구성된 문의 값입니다 output-filename . 디바이스가 1초 동안 이벤트 정책을 여러 번 트리거하는 경우 각 파일 이름에 인덱스 번호 is를 추가하여 파일 이름이 여전히 고유한지 확인합니다. 인덱스 번호 범위는 001에서 999 사이입니다.
예를 들어, Junos OS 릴리스 21.1R1을 실행하는 디바이스 r1에서 로 rpd-messages 구성된 이벤트 정책 작업이 output-filename 있다고 가정해 보겠습니다. 이벤트 정책이 1초에 3번 트리거되는 경우 파일 이름은 다음과 유사합니다.
-
r1_20210623_132333_rpd 메시지
-
r1_20210623_132333_rpd-messages_001
-
r1_20210623_132333_rpd-messages_002
파일이 업로드되기 전 지연 구성
기존 시스템 파일을 업로드하거나 이벤트 발생 시 호출된 이벤트 스크립트 또는 운영 명령에서 생성된 출력 파일을 업로드하도록 이벤트 정책을 구성할 수 있습니다. 이벤트 정책 업로드 작업의 경우, 전송 지연을 구성하여 하나 이상의 파일을 업로드하기 전에 이벤트 프로세스(eventd)가 대기하는 시간(초)을 지정할 수 있습니다. 전송 지연을 구성하면 업로드가 시작되기 전에 코어 파일과 같은 대용량 파일이 완전히 생성되도록 할 수 있습니다.
전송 지연을 대상 및 이벤트 정책 작업과 연결할 수 있습니다. 전송 지연을 대상과 연결하면 해당 대상을 사용하는 모든 파일 업로드 작업에 전송 지연이 적용됩니다. 이벤트 정책 작업에 전송 지연을 할당할 수도 있습니다. 예를 들어, 동일한 대상을 사용하는 여러 이벤트 정책 작업이 있을 수 있으며, 이러한 이벤트 정책 작업 중 일부의 경우 전송 지연을 원하고 다른 이벤트 정책 작업의 경우 전송 지연을 원하지 않을 수 있습니다.
계층 수준에서 대상에 대한 전송 지연을 [edit event-options destinations destination-name] 구성하고 이벤트 정책 작업에 대한 전송 지연도 구성하는 경우, 결과 전송 지연은 두 지연의 합계입니다.
Total transfer delay = transfer-delay (destination) + transfer-delay (event-policy-action)
대상에 대한 전송 지연을 구성하려면,
[edit event-options destinations destination-name] user@host# set transfer-delay seconds
예를 들어, 다음 구성은 mgmt-archives 대상에 대해 전송 지연을 5초로 설정합니다.
[edit event-options destinations mgmt-archives] user@host# set transfer-delay 5
특정 이벤트 정책 작업에 대한 전송 지연을 구성하려면:
-
적절한 이벤트 정책 작업 계층에서 지연 시간(초 단위)을 구성합니다.
[edit event-options policy policy-name then] user@host# set event-script filename destination destination-name transfer-delay seconds
[edit event-options policy policy-name then] user@host# set execute-commands destination destination-name transfer-delay seconds
[edit event-options policy policy-name then] user@host# set upload filename (filename | committed) destination destination-name transfer-delay seconds
예를 들어:
[edit event-options policy policy1 then] user@host# set event-script get-intf-info.py destination mgmt-archives transfer-delay 5
[edit event-options policy policy2 then] user@host# set execute-commands destination mgmt-archives transfer-delay 7
[edit event-options policy policy3 then] user@host# set upload filename committed destination mgmt-archives transfer-delay 3
다음 예에서 some-dest 대상은 이벤트 정책과 policy1 policy2. 2 초의 전송 지연은 대상과 some-dest 연결되며 두 이벤트 정책 모두에 대한 대상에 출력 파일을 업로드하는 데 적용됩니다.
[edit event-options]
policy policy1 {
events e1;
then {
execute-commands {
commands {
"show version";
}
output-filename command-output;
destination some-dest;
}
}
policy policy2 {
events e2;
then {
event-script bar.xsl {
output-filename event-script-output;
destination some-dest;
}
}
}
destinations {
some-dest {
transfer-delay 2;
archive-sites {
"scp://robot@my.big.com/foo/moo" password "$9$wisoGDjqfQnHqIclMN-HqmP5F"; ## SECRET-DATA
"scp://robot@my.little.com/foo/moo" password "$9$uova0RSrlMXNbKMDkPQ9CKM8Lxd"; ## SECRET-DATA
}
}
}
파일 업로드 작업을 다시 시도하도록 이벤트 정책 구성
기존 시스템 파일을 업로드하거나 이벤트 발생 시 호출된 이벤트 스크립트 또는 운영 명령에서 생성된 출력 파일을 업로드하도록 이벤트 정책을 구성할 수 있습니다. 일시적인 네트워크 문제로 인해 파일 업로드 작업이 실패할 수 있습니다. 어떤 이유로든 업로드가 실패하는 경우 기본적으로 이벤트 정책은 업로드를 다시 시도하지 않습니다. 그러나 파일 업로드 작업을 다시 시도하도록 이벤트 정책을 구성할 수 있습니다.
지정된 이벤트 정책 작업에 대해 파일 업로드 재시도 옵션을 구성합니다. 재시도 옵션을 구성하려면 및 retry-interval 문을 포함합니다retry-count.
retry-count number retry-interval seconds;
어디:
-
retry-count- 업로드가 실패할 경우 정책이 업로드 작업을 다시 시도하는 횟수입니다. 문의 기본값은retry-count0이고 최대값은 10입니다. -
retry-interval- 각 업로드 시도 사이의 시간(초)입니다.
지정된 이벤트 정책 작업에 대한 파일 업로드 작업을 다시 시도하도록 이벤트 정책을 구성하려면:
retry-count 이벤트 정책 작업의 destination 문에 및 retry-interval 문을 포함합니다.
[edit event-options policy policy-name then] user@host# set event-script filename destination destination-name retry-count number retry-interval seconds
[edit event-options policy policy-name then] user@host# set execute-commands destination destination-name retry-count number retry-interval seconds
[edit event-options policy policy-name then] user@host# set upload filename (filename | committed) destination destination-name retry-count number retry-interval seconds
예를 들어:
[edit event-options policy policy1 then] user@host# set event-script get-intf-info.py destination mgmt-archives retry-count 5 retry-interval 3
[edit event-options policy policy2 then] user@host# set execute-commands destination mgmt-archives retry-count 10 retry-interval 4
[edit event-options policy policy3 then] user@host# set upload filename committed destination mgmt-archives retry-count 2 retry-interval 10