Quelltext der Seite Oracle Datenbank mit Zabbix überwachen

{{Hinweis| Diese Lösung stammt aus dem Jahre 2013. Das Zabbix-Script/Template wird nun schon (Stand 2021) seit über 5 Jahren nicht mehr weiter entwickelt. Es funktioniert noch, beim letzten Kunden habe ich das Monitoring dann aber mit der Lösung zbxdb gemacht: https://github.com/ikzelf/zbxdb - Einen Artikel dafür habe ich noch nicht erstellt, ich werden diesen aber hier verlinken sobald einer erstellt wurde. Ich habe einen Kunden wo dies demnächst ansteht (unter Ubuntu 20.04 dann). Beim Kunden wo ich es umgesetzt habe kam CentOS 7 zum Einsatz und damit war es ein Grausen}}
[[Kategorie:Zabbix]]
Bei einem Kunden sollte ich eine Überwachung der Oracle Datenbank einrichten.<br>
Insbesondere sollten die '''''Tabelspaces''''' überwacht werden.<br>
Leider scheinen die Lösungen auf www.zabbix.com älter zu sein und haben eben '''''keine Tablespaces'''''.<br>
Gefunden habe ich dann etwas hier: http://bicofino.io/blog/monitoring-oracle-with-zabbix/
<br>
Ich habe die Lösung mal für meine Ubuntu/Zabbix Kombi umgesetzt und das ganze hier beschrieben:<br>
<br>
----
==Voraussetzungen==
* Oracle Client muss installiert werden ( http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html )
* cx_Oracle für Python muss installiert werden ( http://cx-oracle.sourceforge.net/ )
* PyOra muss installiert / eingerichtet werden ( https://github.com/bicofino/Pyora )
<br>
<br>
----
==Installation==
==Vorhandene Oracle Version abfragen==
<u>'''LINUX:'''</u><br>
Meldet euch per SSH am Oracle-Server an und gebt folgenden Befehl ein:<br>
 echo $ORACLE_HOME
Beispielausgabe:<br>
 /oracle/ora112
Bedeutet Version 11.2<br>
<br>
Wer es noch genauer haben will:<br>
 su - oracle
 sqlplus
Beispielausgabe:<br>
 SQL*Plus: Release 11.2.0.3.0 Production on Di Nov 29 09:28:19 2016
 
 Copyright (c) 1982, 2011, Oracle.  All rights reserved.
 
 Benutzernamen eingeben:
<br>
<br>
----
===Oracle Client installieren===
{{Warnung|Ihr müsst mindestens den Client 11.2 installieren, sonst funktioniert es nicht mehr. Der Client funktioniert auch mit 10er Oracleversionen!}}<br>
Den Client findet Ihr unter
 http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html
den 64 Bit-Client unter
 https://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html
Dort müsst Ihr den passenden (64 oder 32 Bit) auswählen.<br>
Ob Ihr ein 32 oder 64Bit Linux habt stellt ihr auf der Bash mit
 root@zabbix:~# uname -m
 x86_64
fest. <code>x86_64</code> bedeutet das es ein 64 Bit System ist, alle anderen Werte bedeuten 32 Bit (z.B. <code>i686</code>).<br>
<br>
Ich habe hier ein 64 Bit System und entsprechend den [http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html Instant Client for Linux x86-64] genommen.<br>
Ihr müsst die Pakete für
* Instant Client Package - Basic:
* Instant Client Package - SDK:
* Instant Client Package - SQL*Plus
herunterladen. Ihr könnt zwischen '''''.zip''''' und '''''.rpm''''' wählen. Wir nehmen dir '''''.rpm''''' Versionen.<br>
<br>
Ich habe hier ein 10g Datenbank, entsprechend waren es die Dateien<br>
 oracle-instantclient-basic-10.2.0.5-1.x86_64.rpm
 oracle-instantclient-devel-10.2.0.5-1.x86_64.rpm
 oracle-instantclient-sqlplus-10.2.0.5-1.x86_64.rpm
die wir nun auf unseren Zabbix Server hochladen.<br>
Dort installieren wir diese mittels <code>alien</code><br>
Wenn <code>alien</code>> auf eurem System fehlt könnt Ihr es mit
 apt-get install alien
nachinstallieren.<br>
Die drei Oracle-Pakete installieren wir mit
 alien -i oracle-instantclient-basic-10.2.0.5-1.x86_64.rpm
 alien -i oracle-instantclient-devel-10.2.0.5-1.x86_64.rpm
 alien -i oracle-instantclient-sqlplus-10.2.0.5-1.x86_64.rpm
<br>
Nach erfolgreicher Installation der 3 Pakete könnt Ihr mit<br>
 sqlplus username/password@//NameDesServers:1521/SID
 sqlplus64 username/password@//NameDesServers:1521/SID
Testen (einer der beiden Befehle je nach Version)<br>
{{Hinweis| Es kann sein das SID nicht funktioniert - dann müsst Ihr ggf. den Namen der Datenbank einsetzen. Gibt es eine Meldung wie <code>TNS:no listener</code> so passt der Datenbankname und/oder der Port nicht.<br>
Wenn Ihr genau wissen wollte welche Dienste (Datenbanken) auf welchen Ports der Oracle Server anbietet so schaut in die Datei <code>listener.ora</code> auf dem Oracle Server (z.B. unter '''''/oracle/ora112/network/admin/listener.ora'''''}}<br>
 

Gibt es dabei einen Fehler<br>
 sqlplus: error while loading shared libraries: libsqlplus.so: cannot open shared object file: No such file or directory
müsst Ihr die Datei
 /etc/ld.so.conf.d/oracle.conf
erstellen und bearbeiten, z.B. mit
 touch /etc/ld.so.conf.d/oracle.conf
 nano /etc/ld.so.conf.d/oracle.conf
und dort gleich am Anfang die Zeile
 /usr/lib/oracle/10.2.0.5/client64/lib/
hinzufügen - den Pfad müsst Ihr ermitteln und er hängt von eurer Version ab (das '''''10.2.0.5''''' und '''''client64''''' ist wahrscheinlich anders.<br>
Im Anschluss noch mal die Konfiguration des Clients aufrufen:<br>
 ldconfig
Gibt es danach den Fehler:<br>
 sqlplus: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory
fehlt müsst ihr diese fehlende Library mit
 apt-get install libaio1
installieren (man beachte die 1 am Ende)
Danach sollte der <code>sqlplus</code> Test klappen.<br>
 sqlplus username/password@//NameDesServers:1521/SID
'''Ausgabe'''
 SQL*Plus: Release 11.1.0.7.0 - Production on Wed Oct 16 15:45:41 2013
 
 Copyright (c) 1982, 2008, Oracle.  All rights reserved.
 
 
 Connected to:
 Oracle Database 10g Release 10.2.0.4.0 - 64bit Production
 
<br>
<br>
----

===ldconfig anpassen===
Nach einem Hinweis von Timo noch die nachfolgenden Ergänzung - sonst meldet das cx_Oracle Script einen Fehler:<br>
<br>
Wir legen eine neue Datei an:<br>
 nano /etc/ld.so.conf.d/oracle.conf
mit folgendem Inhalt:<br>
 /usr/lib/oracle/11.2/client64/lib/
<br>
Den Pfad müsst Ihr an eure Version anpassen, ggf. abfragen mit<br>
 ls -l /usr/lib/oracle/
<br>
Im Anschluß noch ein
 ldconfig
<br>
<br>
----
===cx_Oracle installieren===
Das Script von Bico Fino braucht die '''cx-Oracle''' Bibliothek für Python, die findet ihr hier:<br>
 http://cx-oracle.sourceforge.net/
<br>
<br>
----
====Neuer Weg====
 apt install python-pip
 pip install cx_Oracle
Test:<br>
 python -c 'import cx_Oracle'
sollte '''KEINE''' Fehlermeldung etc. erzeugen.<br>
<br>
<br>
----
====Alter Weg====
Dort müsst ihr die passende Version zum Betriebssystem (64 oder 32 Bit), zur Oracle Installation und zur vorhandenen Python-Version auswählen.
Die Oracle Version wisst Ihr hoffentlich oder fragt den Datenbank-Admin<br>
Wenn Ihr im vorherigen Abschnitt den Verbindugstest gemacht hat steht das da auch gleich nach dem Login auf dem Oracle-Server:<br>
 Connected to:
 Oracle Database 10g Release 10.2.0.4.0 - 64bit Production
<br>
Die Python Version fragt ihr einfach in der Shell ab:
 root@zabbix:~# python --version
 Python 2.7.1+
<br>
So, ich habe hier ein 64Bit Ubuntu, eine Oracle-Datenbank Version 10g und Python Version 2.7<br>
Also lade ich mir unter http://cx-oracle.sourceforge.net/ das Paket 
 •CentOS 5 x86_64 RPM (Oracle 10g, Python 2.7)
herunter. Das hies bei mir<br>
 cx_Oracle-5.1.2-10g-py27-1.x86_64.rpm
welchen wir nun wieder af den Server schieben und mit<br>
 alien -i cx_Oracle-5.1.2-10g-py27-1.x86_64.rpm
Installieren.<br>
Testen können wir das nun mit<br>
 python -c 'import cx_Oracle' 
Wenn es hierbei einen Fehler gibt:<br>
 root@zabbix:~# python -c 'import cx_Oracle'
 Traceback (most recent call last):
   File "<string>", line 1, in <module>
 ImportError: No module named cx_Oracle
Dann liegt es daran daß das Paket die Datei '''cx_Oracle.so''' an den falschen Ort gepackt hat, nämlich nach
 /usr/lib/python2.7/site-packages/
es gehört aber nach<br>
 /usr/lib/python2.7/dist-packages/
Das Problem lösen wir indem wir es zusätzlich an den richtigen Ort verlinken:<br>
 ln /usr/lib/python2.7/site-packages/cx_Oracle.so /usr/lib/python2.7/dist-packages/cx_Oracle.so
 ln /usr/lib/python2.7/site-packages/cx_Oracle-5.1.2-py2.7.egg-info /usr/lib/python2.7/dist-packages/cx_Oracle-5.1.2-py2.7.egg-info
so liegt die gleiche Datei an beiden Orten (es immer die gleiche Datei)<br>
Nun noch einmal testen:<br>
 python -c 'import cx_Oracle'
und die Ausgabe sollte ...<br>
root@zabbix:~/oracle-files# python -c 'import cx_Oracle'
Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: libpython2.7.so.1.0: cannot open shared object file: No such file or directory
Arggh der nächste Fehler ... den Ihr bestimmt nicht habt ...<br>
Ok, den beheben wir mit<br>
 ln /usr/lib/libpyglib-2.0-python2.7.so.0.0.0 /usr/lib/libpython2.7.so.1.0
und dann sollte nach<br>
 python -c 'import cx_Oracle'
einfach nichts passieren!<br>
<br>
<br>
----

===pyora.py installieren===
Ihr geht auf https://github.com/bicofino/Pyora und ladet euch die <code>pyora.py</code> herunter.<br>
<br>
Nun weichen wir ein wenig von dem ab was der Entwickler sich gedacht hat. Dieser hat das Script über den Agenten eingebunden,<br>
wir nutzen einfach das "externalscripts" Verzeichnis von Zabbix und starten es auch als "External Check":<br>
<br>
Kopiert die Datei <code>pyora.py</code> in das Verzeichnis "externalscripts" eurer Zabbix-Installation.<br>
Wenn ihr nach Standard installiert habt findet Ihr es unter
 /usr/local/share/zabbix/externalscripts
Das ist der Pfad der in eurer <code>zabbix_server.conf</code> definiert ist:
 ### Option: ExternalScripts
 #       Full path to location of external scripts.
 #       Default depends on compilation options.
 #
 # Mandatory: no
 # Default:
 # ExternalScripts=${datadir}/zabbix/externalscripts
 ExternalScripts=/usr/local/share/zabbix/externalscripts
Und Ihr müsst die Datei noch ausführbar machen:
 chmod +x pyora.py
<br>
<br>
----
====1. Test====
Wenn Ihr per puTTY in das Verzeichnis wechselt könnt Ihr einen kleine Test mit eurer Datenbank machen:<br>
 ./pyora.py "--username" "benutzer" "--password" "12334" "--address" "database.znil.local" "--database" "TEST23" "bufbusywaits"
Beispielausgabe:<br>
 13649089
Prima! Wenn eine Zahl zurückkommt etc. läuft es.<br>
{{Hinweis| Wenn euer Oracle-Server '''NICHT''' auf dem Port 1521 lauscht so müsst Ihr den richtigen Port immer hinter der IP-Adresse angeben, z.B. '''''192.168.45.77:1531''''' - auch nachfolgend in den Makros für das Template!}}<br>
<br>
<br>

====2. Test====
 ./pyora.py --username "benutzer" --password "12345" --address 123.123.123.123 --database "DATABASE" "version"
Beispielausgabe:<br>

<br>
<br>

==Integration in Zabbix==
In Zabbix importiert Ihr nun das Template ... das vom pyora.py Programmierer funktioniert auf Agentenbasis, ich habe sein Template genommen und auf '''''External Check''''' umgebaut:<br>
<br>
<big>'''[[Media:Template-znil-Oracle-Pyora.zip|Template-znil-Oracle-Pyora.zip]]'''</big> <br>
<big>'''[[Media:znil-Oracle-Pyora.zip|znil-Oracle-Pyora.zip => Export aus Zabbix 4.4.1]]'''</big> <br>
<br>
Dann legt Ihr einen Host an bzw. bearbeitet einen vorhandenen:<br>
[[Datei:Zabbix-Oracle-001.png]]<br>
Statt des DNS-Namens könnt Ihr auch die IP nehmen.<br>
Nun noch das Template mit dem Host verknüpfen:<br>
[[Datei:Zabbix-Oracle-002.png]]<br>
<br>
Nach etwas Geduld kommen die Werte rein:<br>
[[Datei:Zabbix-Oracle-003.png]]<br>
<br>
<br>
<br>
----
So, Scheiss Linux ... soviel fummelei bis ich endlich die richtigen Versionen von Oracle Client, cx_oracle und die Abhängigkeiten zusammen hatte .. man man unter Windows wäre die Installation eines Programmes ein Witz gewesen ...<br>
--[[Benutzer:BLinz|Bernhard Linz]] 16:54, 21. Okt. 2013 (CEST)
----
<comments />