Методические материалы Лохтурова Вячеслава

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Zabbix - построение топологии сети ======

===== Запись =====

  * [[https://youtu.be/ZrNScBG9TnU|Zabbix: топология сети наглядно и автоматически]]

===== История вопроса =====

  * [[http://su.bmstu.ru|Построение топологии сети в МГТУ им.Н.Э.Баумана]]
  * [[https://www.zabbix.com/forum/in-russian/44171-perl-script-%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D1%81%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D1%82%D0%BE%D0%BF%D0%BE%D0%BB%D0%BE%D0%B3%D0%B8%D0%B8-%D1%81%D0%B5%D1%82%D0%B8-%D0%B2-zabbix|Perl script Авторисования топологии сети в Zabbix]]
===== Модуль 1. Развертывание стенда =====

==== Выбор сети для виртуальных машин ====

  * !!! Отключить не используемые адаптеры
  * !!! Не разборчивый режим: разрешить все 

<code>
C:\Users\Student1>ipconfig
...
   IPv4-адрес. . . . . . . . . . . . : 192.168.1.5
   Маска подсети . . . . . . . . . . : 255.255.255.0
   Основной шлюз. . . . . . . . . : 192.168.1.1
</code>

==== Настройка сети сервера мониторинга ====
<code>
# cat /etc/hostname
</code><code>
server.corp1.un
</code><code>
# cat /etc/hosts
</code><code>
127.0.0.1       localhost

192.168.1.100   server.corp1.un server
</code><code>
# cat /etc/resolv.conf
</code><code>
search corp1.un
nameserver 192.168.1.1
</code><code>
# cat /etc/network/interfaces
</code><code>
auto lo
iface lo inet loopback

auto eth0
iface eth0 inet static
        address 192.168.1.100
        netmask 255.255.255.0
        gateway 192.168.1.1
</code>

===== Модуль 2. Развертывание Zabbix =====

==== Zabbix ====

  * [[Локализация системы#Локализация временной зоны]]
  * Установка и запуск сервера в [[Сервис Zabbix#Debian/Ubuntu]]
  * [[Сервис Zabbix#Установка и запуск web интерфейса]]
  * [[Сервис Zabbix#Настройка мониторинга]] - Подключение
===== Модуль 3. Развертывание облака коммутаторов =====

==== Минимальная конфигурация ====
<code>
configure terminal

hostname switchN
ip domain-name corp1.un

int vlan 1
ip address 192.168.1.10N 255.255.255.0
no shut
no ip domain lookup

end

copy running-config startup-config


</code>

===== Модуль 4. Настройка мониторинга коммутаторов с автоматическим добавлением =====

  * [[https://www.zabbix.com/documentation/3.2/ru/manual/discovery/network_discovery|Zabbix Documentation Обнаружение сети]]
  * Настройка коммутаторов
<code>
conf t
snmp-server community public RO
end
wr


</code>

  * [[Сервис SNMP#Установка snmp консоли]]
  * [[Сервис SNMP#Варианты использования snmp консоли в режиме чтения]]

<code>
# service zabbix-server restart
</code>

  * [[Сервис Zabbix#Автоматическое добавление]] устройств в Zabbix
===== Модуль 5. Создание карты сети =====

  * [[https://www.zabbix.com/documentation/3.0/ru/manual/config/visualisation/maps/map|Zabbix Documentation Настройка карты сети]]

!!! Можно, для примера, добавить одну линию связи

<code>
Name: Switches map
Edit Map
  Add
    Type: Host
    Label: switch1
    Host: switch1.corp1.un
    Icons: Switch_(96)
...
    Label: switch2
    Host: switch2.corp1.un
...
    Label: switch3
    Host: switch3.corp1.un
...
</code>
===== Модуль 6. Настройка автоматического создания/обновления линий связи =====

==== Протокол CDP ====

<code>
switch1#show cdp neighbors
Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge
                  S - Switch, H - Host, I - IGMP, r - Repeater

Device ID        Local Intrfce     Holdtme    Capability  Platform  Port ID
switch2.corp1.un Fas 0/N            164        R S I      3640      Fas 0/V
switch3.corp1.un Fas 0/M            165        R S I      3640      Fas 0/W
</code>

==== Протокол RSH ====

  * Настройка коммутаторов
<code>
conf t
ip host server 192.168.1.100
ip rcmd rsh-enable
ip rcmd remote-host root server root enable
end
wr


</code>

  * Подключение с сервера мониторинга
<code>
server.corp1.un:~# apt install rsh-client

server.corp1.un:~# rsh switch1 show cdp neighbors

server.corp1.un:~# apt install dos2unix

server.corp1.un:~# rsh switch1 -n show cdp nei | dos2unix | grep switch | tr -s " " | cut -d " " -f1,2,3,9,10
  или
server.corp1.un:~# rsh switch1 -n show cdp nei | dos2unix | tr '\n' ' ' | sed 's/switch/\nswitch/g' | grep switch | tr -s " " | cut -d " " -f1,2,3,9,10
</code>

==== Zabbix API ====

  * [[https://ru.wikipedia.org/wiki/JSON|Материал из Википедии. JSON]]
  * [[https://www.zabbix.com/documentation/1.8/ru/api/getting_started|Zabbix Documentation Начало работы с Zabbix API]]

=== Аутентификация ===

  * [[https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/36900-api-key-lifetime|api key lifetime]]

<code>
server.corp1.un:~# apt install curl

server.corp1.un:~# curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d '
{
   "jsonrpc": "2.0",
   "method": "user.login",
   "params": {
      "user": "Admin",
      "password": "zabbix"
   },
   "id": 1
} ' http://127.0.0.1/zabbix/api_jsonrpc.php
</code><code>
{"jsonrpc":"2.0","result":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","id":1}
</code>

=== Работа с объектами host ===

  * Утилита для обработки JSON
<code>
server.corp1.un:~# apt install jq
</code>

  * Получение списка идентификаторов и имен коммутаторов из Zabbix

<code>
server.corp1.un:~# curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d '
{
    "jsonrpc": "2.0",
    "method": "host.get",
    "params": {
        "output": "extend"
    },
    "auth": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": 2
} ' http://127.0.0.1/zabbix/api_jsonrpc.php | jq
...
</code>

  * Варианты оформления "params" ([[https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/25384-zabbix-json-api-output-parameter|Zabbix JSON API output parameter]]):
<code>
...
    "params": {},
...
</code><code>
...
    "params": {
        "output": ["hostid", "host"]
    },
...
</code>

  * Оформление запросов в виде BASH скриптов

<code>
server.corp1.un:~# export AUTH=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

server.corp1.un:~# cat /root/zab_get_hosts.sh
</code><code>
#!/bin/sh

curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d "
{
    \"jsonrpc\": \"2.0\",
    \"method\": \"host.get\",
    \"params\": {},
    \"auth\": \"${AUTH}\",
    \"id\": 2
} " http://127.0.0.1/zabbix/api_jsonrpc.php
</code><code>

server.corp1.un:~# /root/zab_get_hosts.sh | jq '.result | .[] | .host'

server.corp1.un:~# /root/zab_get_hosts.sh | jq '.result | .[] | {hostid: .hostid, host: .host}'

server.corp1.un:~# /root/zab_get_hosts.sh | jq '.result | .[] | {hostid: .hostid, host: .host} | tostring'

server.corp1.un:~# /root/zab_get_hosts.sh | jq '.result | .[] | {hostid: .hostid, host: .host} | tostring' | grep switch | tr -d '{}\\' | tr '"' ' ' | cut -d ' ' -f5,9 
</code>
Добавляем конвейер в конец скрипта и записываем результат в файл:
<code>
server.corp1.un:~# /root/zab_get_hosts.sh | tee list_hostid_host.txt
</code><code>
10111 switch1.corp1.un
10112 switch2.corp1.un
10113 switch3.corp1.un
</code>

=== Получение списка карт и их элементов из Zabbix ===

<code>
server.corp1.un:~# cat /root/zab_get_maps.sh
</code><code>
#!/bin/sh

curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d "
{
    \"jsonrpc\": \"2.0\",
    \"method\": \"map.get\",
    \"params\": {
        \"selectLinks\": \"extend\",
        \"selectSelements\": \"extend\"
    },
    \"auth\": \"${AUTH}\",
    \"id\": 2
} " http://127.0.0.1/zabbix/api_jsonrpc.php | \
#jq
###zabbix3
jq '.result | .[] | .selements | .[] | {elementid: .elementid, selementid: .selementid} | tostring' | tr -d '{}\\' | tr '"' ' ' | cut -d ' ' -f5,9
###zabbix4
#jq '.result[1].selements[] | {elements, selementid} | tostring' | tr -d '{}\\' | tr '"' ' ' | cut -d ' ' -f7,11
</code><code>
server.corp1.un:~# /root/zab_get_maps.sh | tee list_hostid_selementid.txt
</code><code>
10084 1
10111 2
10112 3
10113 4
</code>

=== Сводим все вместе, через CDP и RSH, выясняем, какие коммутаторы на карте через какие интерфейсы связаны ===

<code>
server.corp1.un:~# cat /root/rsh_get_links.sh
</code><code>
#!/bin/sh

LIST_HOSTID_HOST=/root/list_hostid_host.txt
LIST_HOSTID_SELEMENTID=/root/list_hostid_selementid.txt

while read HOSTID HOST
do
        rsh $HOST -n show cdp nei | dos2unix | grep switch | tr -s " " | cut -d " " -f1,2,3,9,10 |
        while read CDPNEI LINKINTFACES
        do
                HOSTID2=`grep $CDPNEI $LIST_HOSTID_HOST | cut -d' ' -f1`
                SELEMENT2=`grep $HOSTID2 $LIST_HOSTID_SELEMENTID | cut -d' ' -f2`
                SELEMENT1=`grep $HOSTID $LIST_HOSTID_SELEMENTID | cut -d' ' -f2`
                echo $SELEMENT1 $SELEMENT2 $LINKINTFACES
        done
done < $LIST_HOSTID_HOST
</code><code>
server.corp1.un:~# /root/rsh_get_links.sh | tee list_selements_label.txt
</code><code>
2 3 Fas 0/2 Fas 0/5
2 4 Fas 0/8 Fas 0/5
3 2 Fas 0/5 Fas 0/2
4 2 Fas 0/5 Fas 0/8
</code>

=== Рисование линий связи в Zabbix ===

  * [[https://www.zabbix.com/documentation/3.0/manual/api/reference/map/create|Zabbix Documentation - map.create]]
  * [[https://www.zabbix.com/documentation/3.0/manual/api/reference/map/update|Zabbix Documentation - map.update]]

Простой пример изменения конфигурации через Zabbix API
<code>
server.corp1.un:~# cat /root/zab_set_map_name.sh
</code><code>
#!/bin/sh

MAPID=$1
MAPNAME=$2

curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d "
{
    \"jsonrpc\": \"2.0\",
    \"method\": \"map.update\",
    \"params\": {
        \"sysmapid\": \"${MAPID}\",
        \"name\": \"${MAPNAME}\"
    },
    \"auth\": \"${AUTH}\",
    \"id\": 2
} " http://127.0.0.1/zabbix/api_jsonrpc.php
</code><code>
server.corp1.un:~# /root/zab_set_map_name.sh 2 "Super MAP"
</code><code>
server.corp1.un:~# cat /root/zab_set_link_name.sh
</code><code>
#!/bin/sh

MAPID=2
SELEMENTS_LABEL=/root/list_selements_label.txt

LINKS=""

while read SELEMENTID1 SELEMENTID2 LABEL
do
        LINKS="$LINKS
                {
                        \"label\": \"${LABEL}\",
                        \"selementid1\": \"${SELEMENTID1}\",
                        \"selementid2\": \"${SELEMENTID2}\"
                },"
done < $SELEMENTS_LABEL

#LINKS=`echo $LINKS | rev | cut -c 2- | rev`
#LINKS=`echo -n ${LINKS::-1}`

JSON="
{
    \"jsonrpc\": \"2.0\",
    \"method\": \"map.update\",
    \"params\": {
        \"sysmapid\": \"${MAPID}\",

        \"links\": [
                ${LINKS}
        ]
    },
    \"auth\": \"${AUTH}\",
    \"id\": 2
} "

curl -s -k -X POST -H 'Content-Type: application/json-rpc' -d "$JSON" http://127.0.0.1/zabbix/api_jsonrpc.php
</code><code>
server.corp1.un:~# /root/zab_set_link_name.sh
</code>

=== Алгоритм добавления коммутатора ===

  * Добавляем в GNS новый коммутатор (с snmp и rsh) и ждем, пока он появится в Zabbix, затем:
<code>
server.corp1.un:~# /root/zab_get_hosts.sh | tee list_hostid_host.txt
</code>

  * Добавляем новый коммутатор на карту (и не забываем сохранить!!!), затем:
<code>
server.corp1.un:~# /root/zab_get_maps.sh | tee list_hostid_selementid.txt
</code>

  * Затем, а так же, при изменении топологии (в GNS перезагрузить узлы для поднятия линков и чистки таблиц CDP)
<code>
server.corp1.un:~# /root/rsh_get_links.sh | tee list_selements_label.txt
</code>
  * Затем, перерисовываем связи:
<code>
server.corp1.un:~# /root/zab_set_link_name.sh
</code>
Методические материалы Лохтурова Вячеслава

User Tools

Site Tools

Page Tools
