JavaScript를 사용하여 Zabbix의 실제 문제를 해결합니다.

티콘 우스코프, Zabbix 통합 팀 엔지니어

Zabbix는 모든 종류의 데이터를 모니터링하는 데 사용되는 맞춤형 플랫폼입니다. Zabbix 초기 버전부터 모니터링 관리자는 다음을 통해 다양한 스크립트를 실행할 수 있었습니다. 행위 대상 네트워크 노드를 확인합니다. 동시에 스크립트 출시로 인해 스크립트 지원 필요성, 통신 노드 및 프록시로의 전달, 다양한 버전 지원 등 여러 가지 어려움이 발생했습니다.

자빅스용 자바스크립트

2019년 4.2월, JavaScript 전처리와 함께 Zabbix 3.4가 도입되었습니다. 많은 사람들이 데이터를 어딘가로 가져와 소화하고 Zabbix가 이해하는 형식으로 제공하고 Zabbix에서 저장 및 처리할 준비가 되지 않은 데이터를 수신하는 간단한 검사를 수행하는 스크립트 작성을 포기하고 그런 다음 Zabbix 및 JavaScript 도구를 사용하여 이 데이터 스트림을 처리합니다. Zabbix XNUMX에 등장한 하위 수준 검색 및 종속 항목과 함께 수신된 데이터를 정렬하고 관리하기 위한 상당히 유연한 개념을 얻었습니다.

Zabbix 4.4에서는 JavaScript 사전 처리의 논리적 연속으로 Zabbix 알림을 타사 응용 프로그램과 쉽게 통합하는 데 사용할 수 있는 Webhook이라는 새로운 알림 방법이 등장했습니다.

자바스크립트와 덕테이프

JavaScript와 Duktape을 선택한 이유는 무엇입니까? 언어 및 엔진에 대한 다양한 옵션이 고려되었습니다.

• 루아 - 루아 5.1
• 루아 - LuaJIT
• 자바스크립트 - 덕테이프
• 자바스크립트 - 제리스크립트
• 임베디드 파이썬
• 임베디드 펄

주요 선택 기준은 보급, 제품에 엔진 통합의 용이성, 엔진의 낮은 리소스 소비 및 전반적인 성능, 이 언어로 된 코드를 모니터링에 도입하는 안전성이었습니다. 지표의 조합을 기반으로 JavaScript가 Duktape 엔진에서 승리했습니다.

선택 기준 및 성능 테스트

덕테이프의 특징:

- 기준 ECMA스크립트 E5/E5.1
— Duktape용 Zabbix 모듈:

• Zabbix.log() - 다양한 세부 수준의 메시지를 Zabbix 서버 로그에 직접 작성할 수 있습니다. 예를 들어 Webhook의 오류를 서버 상태와 연관시킬 수 있습니다.
• CurlHttpRequest() - Webhook 사용을 기반으로 하는 네트워크에 HTTP 요청을 할 수 있습니다.
• atob() 및 btoa() - Base64 형식으로 문자열을 인코딩 및 디코딩할 수 있습니다.

참고. Duktape는 ACME 표준을 준수합니다. Zabbix는 스크립트의 2015 버전을 사용합니다. 후속 변경 사항은 사소하므로 무시해도 됩니다..

자바스크립트 마법

JavaScript의 모든 마법은 문자열, 숫자 및 부울과 같은 동적 타이핑 및 유형 캐스팅에 있습니다.

이는 변수가 값을 반환해야 하는 유형을 미리 선언할 필요가 없음을 의미합니다.

수학 연산에서 함수 연산자가 반환한 값은 숫자로 변환됩니다. 이러한 연산의 예외는 덧셈입니다. 용어 중 적어도 하나가 문자열이면 문자열 변환이 모든 용어에 적용되기 때문입니다.

참고. 이러한 변환을 담당하는 메소드는 일반적으로 객체의 상위 프로토타입에서 구현됩니다. 가치의 и toString. 가치의 숫자 변환 중에 호출되며 항상 메소드 전에 호출됩니다. toString. 방법 가치의 기본 값을 반환해야 합니다. 그렇지 않으면 결과가 무시됩니다.

메소드가 객체에서 호출됨 값의. 찾을 수 없거나 기본 값을 반환하지 않으면 메서드가 호출됩니다. toString. 만약 방법이 toString 찾을 수 없음, 검색 중 가치의 객체의 프로토타입에서 값의 처리가 완료되고 표현식의 모든 값이 동일한 유형으로 캐스트될 때까지 모든 것이 반복됩니다.. 객체가 메서드를 구현하는 경우 toString, 프리미티브 값을 반환하면 문자열 변환에 사용됩니다. 그러나 이 방법을 적용한 결과가 반드시 문자열일 필요는 없습니다.

예를 들어, for for object 'obj' 메서드가 정의되었습니다. toString,

`var obj = { toString() { return "200" }}` 

метод toString 정확히 문자열을 반환하고 숫자가 있는 문자열을 추가하면 접착된 문자열을 얻습니다.

`obj + 1 // '2001'` 

`obj + 'a' // ‘200a'`

하지만 다시 작성하면 toString메서드가 숫자를 반환하기 위해 개체가 추가될 때 숫자 변환이 포함된 수학 연산이 수행되고 수학 추가 결과가 얻어집니다.

`var obj = { toString() { return 200 }}` 

`obj + 1 // '2001'`

이 경우 문자열로 더하기를 수행하면 문자열 변환이 수행되고 접착된 문자열을 얻습니다.

`obj + 'a' // ‘200a'`

이것이 초보 JavaScript 사용자가 많은 실수를 하는 이유입니다.

방법 toString 객체의 현재 값을 1씩 증가시키는 함수를 작성할 수 있습니다.

변수가 3이고 4인 경우 스크립트 실행.

캐스트(==)와 비교할 때 메서드는 매번 실행됩니다. toString 가치 증가 기능으로. 따라서 각 후속 비교에서 값이 증가합니다. 비캐스트 비교(===)를 사용하면 이를 방지할 수 있습니다.

타입 캐스팅 없이 비교

참고. 캐스트 비교를 불필요하게 사용하지 마십시오.

복잡한 로직을 가진 Webhook과 같이 타입 캐스팅과의 비교가 필요한 복잡한 스크립트의 경우 변수를 반환하고 불일치 및 오류를 처리하는 값에 대한 검사를 미리 작성하는 것이 좋습니다.

웹훅 미디어

2019년 말과 2020년 초에 Zabbix 통합 팀은 Zabbix 배포판과 함께 제공되는 Webhook 및 즉시 사용 가능한 통합을 적극적으로 개발해 왔습니다.

• 디스코드
• 락스
• 지라 서비스 데스크
• 가장 중요한
• Microsoft 팀
• 옵스제니
• OTR
• 페이지 듀티
• 푸시 오버
• 레드 마인
• ServiceNow
• 싱글4
• 느슨하게
• 텔레그램
• 잠마드
• 젠 데스크

에 링크 문서

전처리

• JavaScript에서 전처리의 출현으로 대부분의 외부 스크립트를 포기할 수 있게 되었으며 현재 Zabbix에서는 모든 값을 가져와 완전히 다른 값으로 변환할 수 있습니다.
• Zabbix의 전처리는 JavaScript 코드에 의해 구현되며 바이트 코드로 컴파일되면 단일 값을 매개 변수로 사용하는 함수로 변환됩니다. 가치 문자열로(문자열에는 숫자와 숫자가 모두 포함될 수 있음).
• 출력은 함수이므로 스크립트 끝에는 필수 return.
• 코드에서 사용자 지정 매크로를 사용할 수 있습니다.
• 리소스는 운영 체제 수준뿐만 아니라 프로그래밍 방식으로도 제한될 수 있습니다. 전처리 단계에는 최대 10MB의 RAM과 10초의 실행 시간 제한이 할당됩니다.

참고. 다소 "무거운" 전처리 시나리오에 따라 조건부로 수천 개의 데이터 항목을 10초에 수집하면 Zabbix의 속도가 느려질 수 있기 때문에 1초의 시간 초과 값은 상당히 큽니다. 따라서 전처리를 수행하기 위해서만 실행되는 소위 섀도우 데이터 요소(더미 항목)를 통해 본격적인 JavaScript 스크립트를 실행하기 위해 전처리를 사용하는 것은 권장되지 않습니다..

전처리 테스트 또는 유틸리티를 사용하여 코드를 확인할 수 있습니다. zabbix_js:

`zabbix_js -s *script-file -p *input-param* [-l log-level] [-t timeout]`

`zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]`

`zabbix_js -h`

`zabbix_js -V`

실용적인 작업

태스크 1

계산된 항목을 전처리로 바꿉니다.

조건: 센서에서 화씨 온도를 가져와서 섭씨로 저장합니다.

이전에는 온도를 화씨 단위로 수집하는 항목을 만들었습니다. 그 후 수식을 사용하여 화씨를 섭씨로 변환하는 또 다른 데이터 항목(계산됨)이 있습니다.

문제:

• 데이터 요소를 복제하고 모든 값을 데이터베이스에 저장해야 합니다.
• 수식에서 계산 및 사용되는 "상위" 데이터 항목과 계산된 데이터 항목의 간격에 동의해야 합니다. 그렇지 않으면 계산 항목이 지원되지 않는 상태가 되거나 이전 값을 계산하여 모니터링 결과의 신뢰성에 영향을 미칠 수 있습니다.

한 가지 해결책은 계산된 항목이 데이터를 수신한 항목(이 경우 화씨 온도) 이후에 평가되도록 하기 위해 고정된 간격을 선호하는 유연한 검사 간격에서 벗어나는 것이었습니다.

그러나 예를 들어 템플릿을 사용하여 많은 수의 장치를 확인하고 30초마다 확인이 수행되는 경우 Zabbix는 29초 동안 "해킹"하고 마지막 순간에 확인 및 계산을 시작합니다. 이렇게 하면 대기열이 생성되고 성능에 영향을 미칩니다. 따라서 꼭 필요한 경우에만 고정 간격을 사용하는 것이 좋습니다.

이 문제에서 최적의 솔루션은 화씨를 섭씨로 변환하는 한 줄 JavaScript 사전 처리입니다.

`return (value - 32) * 5 / 9;`

빠르고 쉬우며 불필요한 데이터 항목을 생성하고 기록을 유지할 필요가 없으며 검사를 위해 유연한 간격을 사용할 수도 있습니다.

`return (parseInt(value) + parseInt("{$EXAMPLE.MACRO}"));`

그러나 가상 상황에서 예를 들어 매크로에 정의된 상수와 함께 수신된 데이터 요소를 추가해야 하는 경우 매개변수가 다음과 같은 점을 고려해야 합니다. 가치 문자열로 확장됩니다. 문자열 추가 작업에서 두 ​​문자열은 단순히 하나로 결합됩니다.

`return (value + "{$EXAMPLE.MACRO}");`

수학 연산의 결과를 얻으려면 얻은 값의 유형을 숫자 형식으로 변환해야 합니다. 이를 위해 다음 기능을 사용할 수 있습니다. 구문 분석(), 정수, 함수를 생성합니다. 구문 분석 플로트(), 십진수 또는 함수를 생성합니다. 번호, 정수 또는 소수를 반환합니다.

2 작업

인증서가 끝날 때까지의 시간을 초 단위로 가져옵니다.

조건: 서비스는 "Feb 12 12:33:56 2022 GMT" 형식으로 인증서 만료 날짜를 발급합니다.

ECMAScript5에서 Date.parse () ISO 8601 형식(YYYY-MM-DDTHH:mm:ss.sssZ)의 날짜를 허용합니다. MMM DD YYYY HH:mm:ss ZZ 형식으로 문자열을 캐스팅해야 합니다.

문제: 월 값을 숫자가 아닌 텍스트로 표현합니다. 이 형식의 데이터는 Duktape에서 허용되지 않습니다.

솔루션 예:

• 우선, 값을 갖는 변수가 선언됩니다(전체 스크립트는 쉼표로 구분되어 나열되는 변수 선언입니다).

• 첫 번째 줄에서 우리는 매개 변수에서 날짜를 얻습니다. 가치 메서드를 사용하여 공백으로 구분합니다. 분열. 따라서 인덱스 0에서 시작하는 배열의 각 요소가 공백 전후의 날짜 요소 하나에 해당하는 배열을 얻습니다. 분할(0) - 월, 분할(1) - 숫자, 분할(2) - 시간 등이 포함된 문자열. 그 후 날짜의 각 요소는 배열의 인덱스로 액세스할 수 있습니다.

`var split = value.split(' '),`

• 각 월(연대순)은 배열에서 해당 위치의 인덱스(0에서 11까지)에 해당합니다. 텍스트 값을 숫자 값으로 변환하려면 월 인덱스에 1이 추가됩니다(월은 XNUMX부터 시작하여 번호가 지정되기 때문). 이 경우 하나를 추가한 표현식은 괄호로 묶습니다. 그렇지 않으면 숫자가 아닌 문자열을 얻게 되기 때문입니다. 결국 우리는 일부분() - 배열을 끝에서 잘라 두 글자만 남깁니다(두 자리 숫자가 있는 달의 경우 중요함).

`MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],`

`month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),`

• 일반적인 문자열을 적절한 순서로 추가하여 얻은 값에서 ISO 형식의 문자열을 형성합니다.

`ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],`

결과 형식의 데이터는 1970년부터 미래의 특정 시점까지의 시간(초)입니다. 수신된 형식의 데이터를 트리거에서 사용하는 것은 거의 불가능합니다. 왜냐하면 Zabbix는 매크로에서만 작동할 수 있기 때문입니다. {데이트} и {시간}, 사용자에게 친숙한 형식으로 날짜와 시간을 반환합니다.

• 그런 다음 Unix 타임스탬프 형식의 JavaScript에서 현재 날짜를 가져오고 결과 인증서 만료 날짜에서 빼서 지금부터 인증서가 만료될 때까지의 밀리초 수를 얻을 수 있습니다.

`now = Date.now();`

• 받은 값을 천으로 나누어 Zabbix에서 초를 얻습니다.

`return parseInt((Date.parse(ISOdate) - now) / 1000);`

트리거에서 ' 식을 지정할 수 있습니다.마지막' 및 응답하려는 기간(예: 주)의 초 수에 해당하는 일련의 숫자입니다. 따라서 트리거는 인증서가 일주일 후에 만료됨을 알립니다.

참고. 사용에 주의 구문 분석() 기능에서 return밀리초를 정수로 나눈 결과의 분수를 변환합니다. 당신은 또한 사용할 수 있습니다 구문 분석 플로트() 소수 데이터 저장.

보고서 보기

출처 : habr.com