Seite wählen

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.