Zabbix - 매크로 경계 확장

클라이언트를 위한 솔루션을 만들 때 일반 Zabbix 기능으로 아름답게 해결하고 싶었던 두 가지 작업이 생겼습니다.

작업 1. Mikrotik 라우터에서 현재 펌웨어 버전을 추적합니다.

HTTP 템플릿에 에이전트를 추가하면 작업이 쉽게 해결됩니다. 에이전트는 Mikrotik 웹 사이트에서 현재 버전을 수신하고 트리거는 현재 버전과 현재 버전을 비교하고 불일치하는 경우 경고를 발행합니다.

10개의 라우터가 있는 경우 이러한 알고리즘이 중요하지 않지만 3000개의 라우터를 사용하려면 어떻게 해야 합니까? 서버에 3000개의 요청을 보내시겠습니까? 물론 그러한 계획은 효과가 있지만 3000 요청이라는 아이디어 자체가 나에게 적합하지 않았기 때문에 다른 솔루션을 찾고 싶었습니다. 또한 이러한 알고리즘에는 여전히 단점이 있습니다. 상대방은 DoS 공격에 대한 한 IP의 요청 수를 계산할 수 있으며 단순히 금지할 수 있습니다.

작업 2. 다른 HTTP 에이전트에서 인증 세션 사용.

에이전트가 HTTP를 통해 "닫힌" 페이지에서 정보를 수신해야 하는 경우 인증 쿠키가 필요합니다. 이를 위해 일반적으로 "로그인/비밀번호" 쌍이 포함된 표준 인증 양식이 있으며 쿠키에 세션 ID를 설정합니다.

그러나 하나의 HTTP 에이전트 항목에서 다른 항목의 데이터에 접근하여 Header에서 이 값을 대체할 수 없다는 문제가 있습니다.

"웹 스크립트"도 있으며 또 다른 제한 사항이 있으며 분석 및 추가 저장을 위해 콘텐츠를 가져올 수 없습니다. 페이지에 필요한 변수가 있는지 확인하거나 이전에 받은 변수를 웹 스크립트 단계 간에 전달할 수만 있습니다.

이러한 작업에 대해 조금 생각한 후 모니터링 시스템의 모든 부분(템플릿, 호스트, 트리거 또는 항목)에서 완벽하게 볼 수 있는 매크로를 사용하기로 결정했습니다. 그리고 웹 인터페이스 API를 통해 매크로를 업데이트할 수 있습니다.

Zabbix는 우수하고 상세한 API 문서를 보유하고 있습니다. API를 통한 데이터 교환에는 Json 데이터 형식이 사용됩니다. 자세한 내용은 공식 문서.

필요한 데이터를 얻고 매크로에 기록하는 작업 순서는 아래 다이어그램에 나와 있습니다.

1 단계

첫 번째 단계는 단일 작업 또는 여러 작업으로 구성될 수 있습니다. 모든 주요 논리는 첫 번째 단계에 있으며 마지막 3단계는 주요 논리입니다.

내 예에서 첫 번째 단계는 첫 번째 작업을 위해 PBX에서 인증 쿠키를 가져오는 것이었습니다. 두 번째 작업을 위해 Mikrotik 펌웨어의 현재 버전 번호를 얻었습니다.

Mikrotik 펌웨어 현재 버전의 URL

• 업그레이드.mikrotik.com/routeros/LATEST.6 - 현재 안정 버전의 URL 주소
• 업그레이드.mikrotik.com/routeros/LATEST.6fix — 현재 LTS 버전의 URL 주소

이 주소는 사용 가능한 최신 펌웨어 버전을 수신할 때 Mikrotik 장비 자체에서 액세스합니다.

첫 번째 단계는 각 사례마다 완전히 개별적이며 작업 논리가 다를 수 있습니다. 그것은 모두 당신의 작업에 달려 있습니다.

웹 스크립팅으로 작업할 때 필요한 응답 방법을 추적하십시오. 제목 HTTP 응답 또는 자체 тело 헤더가 없는 응답?
인증 쿠키가 필요한 경우 응답 방법을 설정하십시오. 제목 별표의 경우처럼.

데이터가 필요한 경우 mikrotik 서버 응답의 경우와 같이 넣어 몸 헤더가 없는 응답.

2 단계

두 번째 단계로 넘어 갑시다. 인증 세션 받기:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
        "user": "Admin"
        "password": "zabbix"
    },
    "id": 1,
    "auth": null
}

jsonrpc는 사용 중인 JSON-RPC 프로토콜의 버전입니다.
Zabbix는 JSON-RPC 버전 2.0을 구현합니다.

• method - 호출되는 메소드.
• params - 메소드에 의해 전달되는 매개변수.
• id는 임의의 요청 식별자입니다.
• auth - 사용자 인증 키; 아직 가지고 있지 않으므로 null로 설정하겠습니다.

API를 사용하기 위해 권한이 제한된 별도의 계정을 만들었습니다. 첫째, 필요하지 않은 곳에 접근 권한을 부여할 필요가 없습니다. 둘째, 5.0 이전 버전에서는 매크로를 통해 설정된 비밀번호를 읽을 수 있었습니다. 따라서 Zabbix 관리자 비밀번호를 사용하면 admin 계정을 도용하기 쉽습니다.

이는 타사 스크립트를 통해 API로 작업하고 측면에 자격 증명을 저장할 때 특히 그렇습니다.

버전 5.0부터 매크로에 저장된 암호를 숨기는 옵션이 있습니다.

API를 통해 데이터를 업데이트하기 위해 별도의 계정을 생성할 때 웹 인터페이스를 통해 필요한 데이터를 사용할 수 있는지 여부와 업데이트가 가능한지 확인하십시오. 나는 확인하지 않았고 오랫동안 내가 필요한 매크로가 API에 표시되지 않는 이유를 이해할 수 없었습니다.

API에서 승인을 받은 후 매크로 목록 가져오기를 진행합니다.

3 단계

API는 호스트 매크로를 이름으로 업데이트하는 것을 허용하지 않으므로 먼저 매크로 ID를 가져와야 합니다. 또한 특정 호스트에 대한 매크로 목록을 얻으려면 이 호스트의 ID를 알아야 하며 이는 추가 요청입니다. 기본 매크로 사용 {호스트 ID} 요청에 허용되지 않습니다. 다음과 같이 제한을 우회하기로 결정했습니다.

이 호스트의 ID로 로컬 매크로를 만들었습니다. 웹 인터페이스에서 호스트 ID를 찾는 것은 매우 쉽습니다.

지정된 호스트의 모든 매크로 목록이 포함된 응답은 패턴으로 필터링할 수 있습니다.

regex:{"hostmacroid":"([0-9]+)"[A-z0-9,":]+"{$MIKROTIK_VERSION}"

따라서 필요한 매크로의 ID를 얻습니다. 여기서 MIKROTIK_버전 우리가 찾고 있는 매크로의 이름입니다. 내 경우에는 매크로가 검색됩니다. MIKROTIK_버전호스트에 할당된 입니다.

요청 자체는 다음과 같습니다.

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.get",
    "params":{
        "output":"extend",
        "hostids":"{$HOST_ID}"
    },
    "auth":"{sid}",
    "id":1
}

변수 {sid} 두 번째 단계에서 획득하고 API 인터페이스로 작업해야 하는 곳에서 지속적으로 사용됩니다.

마지막 4단계 - 매크로 업데이트

이제 업데이트해야 하는 매크로 ID, 인증 쿠키 또는 라우터의 펌웨어 버전을 알고 있습니다. 매크로 자체를 업데이트할 수 있습니다.

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.update",
    "params":{
        "hostmacroid":"{hostmacroid}",
        "value":"{mikrotik_version}"
    },
    "auth":"{sid}",
    "id":1
}

{미크로틱_버전} 첫 번째 단계에서 얻은 값입니다. 내 예에서 현재 mikrotik 펌웨어 버전
{호스트마크로이드} - 값은 세 번째 단계에서 얻었습니다. - 업데이트 중인 매크로의 ID입니다.

조사 결과

표준 기능으로 문제를 해결하는 방법은 훨씬 더 복잡하고 길다. 특히 프로그래밍을 알고 스크립트에 필요한 논리를 빠르게 추가할 수 있는 경우.

이 접근 방식의 확실한 장점은 서로 다른 서버 간의 솔루션 "이동성"입니다.

개인적으로 HTTP 에이전트가 다른 항목의 데이터에 액세스할 수 없고 요청 본문이나 헤더에서 대체할 수 없다는 것이 이상합니다. ZBXNEXT-5993].

완성된 템플릿은 GitHub에서 다운로드.

출처 : habr.com