Support Collector
Der Support-Collector ermöglicht es unseren Kunden automatisch alle relevanten Informationen von ihrem System zu sammeln. Eine daraus resultierende ZIP-Datei kann im Anschluss unserem Support-Team zur Verfügung gestellt werden. Die gesammelten Daten geben uns einen detaillierten Überblick über die Umgebung, wodurch das oft nötige Nachfragen und Sammeln nach beispielsweise Versionen oder Konfigurationen nicht mehr notwendig ist.
Bei der Zusammenstellung der Daten werden alle gängigen Passwörter und Token vor dem Generieren der ZIP Datei entfernt, um die notwendige Sicherheit zu gewährleisten. Die gesammelten Daten liegen im Klartext vor und sollten vor dem Versand auf sensible Inhalte geprüft werden.
Informationen der folgenden Tools werden aktuell durch den Support Collector gesammelt:
- Base (System Informationen)
- Icinga 2
- Icinga Web 2
- Icinga 2 Director
- Mysql / MariaDB
- InfluxDB
- PostgreSQL
- Ansible
- Puppet
- Graphite
- Grafana
Der Quellcode ist auf GitHub unter NETWAYS/support-collector einzusehen.
Benutzung
Standardmäßig sammelt der Support Collector alle Daten, die er auf dem System findet und speichert diese in eine Zip Datei. Dafür sind keine weiteren Optionen nötig. Der Pfad zur generierten Datei wird am Ende des Aufrufes ausgegeben.
$ support-collector
Es besteht jedoch die Möglichkeit benutzerspezifische Einstellungen vorzunehmen, falls dies gewünscht ist.
$ support-collector --help Usage of support-collector: -o, --output string Output file for the ZIP content (default "netways-support-20220316-1109.zip") --enable strings List of enabled module (default [base,icinga2,icingaweb2,icinga-director,mysql,influxdb,postgresql,ansible,puppet,grafana,graphite]) --disable strings List of disabled module --command-timeout duration Timeout for command execution in modules (default 1m0s) -v, --verbose Enable verbose logging -V, --version Print version and exit
Beispiel Aufruf inklusive Ausgabe:
[root@support-collector-demo ~]# support-collector INFO[0000] Starting NETWAYS support collector version 0.5.1 INFO[0000] Collecting Base system information INFO[0000] Collecting Icinga 2 system information INFO[0000] Collecting Icinga Web 2 information INFO[0003] Could not find Icinga Director INFO[0003] Collecting MySQL/MariaDB information INFO[0004] Could not find InfluxDB INFO[0004] Could not find PostgreSQL INFO[0004] Could not find ansible INFO[0004] Could not find puppet INFO[0004] Could not find grafana INFO[0004] Could not find graphite INFO[0004] Obfuscation replaced 21 token in 9 files (4 definitions) INFO[0004] Collection complete, took us 32.163 seconds INFO[0004] Generated ZIP file located at /root/netways-support-20220316-1115.zip
Installation
Die Installation des Support Collectors kann über den NETWAYS Paket Server erfolgen:
RHEL 7 & Centos 7
$ yum install https://packages.netways.de/extras/epel/7/noarch/netways-extras-release/netways-extras-release-7-1.el7.netways.noarch.rpm $ yum install netways-support-collector
RHEL 8 & Centos Stream 8
$ dnf install https://packages.netways.de/extras/epel/7/noarch/netways-extras-release/netways-extras-release-7-1.el7.netways.noarch.rpm $ dnf install netways-support-collector
Debian Buster
$ wget -O - https://packages.netways.de/netways-repo.asc | sudo apt-key add - $ echo "deb https://packages.netways.de/extras/debian buster main" | sudo tee /etc/apt/sources.list.d/netways-extras-release.list $ apt update $ apt install netways-support-collector
Debian Bullseye
$ wget -O - https://packages.netways.de/netways-repo.asc | sudo apt-key add - $ echo "deb https://packages.netways.de/extras/debian bullseye main" | sudo tee /etc/apt/sources.list.d/netways-extras-release.list $ apt update $ apt install netways-support-collector
Ubuntu Bionic Beaver
$ wget -O - https://packages.netways.de/netways-repo.asc | sudo apt-key add - $ echo "deb https://packages.netways.de/extras/ubuntu bionic main" | sudo tee /etc/apt/sources.list.d/netways-extras-release.list $ apt update $ apt install netways-support-collector
Ubuntu Focal Fossa
$ wget -O - https://packages.netways.de/netways-repo.asc | sudo apt-key add - $ echo "deb https://packages.netways.de/extras/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/netways-extras-release.list $ apt update $ apt install netways-support-collector
Neben den offiziellen NETWAYS Paketquellen für den Support Collector, werden bei jedem Release in GitHub Binaries des Tools angeboten.