check_oracle_health 监控

benrych 发表于 2011-12-22 08:54

check_oracle_health check_oracle_health ist ein Plugin, mit dem unterschiedliche Parameter einer Oracle-Datenbank überprüft werden können.

Dokumentation

Kommandozeilenparameter

<ul><li>–connect= Der Datenbankname </li><li>–user= Der Datenbankuser </li><li>–password= Dessen Passwort </li><li>–connect= Alternative zu den obigen Parametern. </li><li>–connect=sysdba@ Anmeldung mit / as sysdba (wenn der aufrufende User dazu privilegiert ist) </li><li>–connect=/@token Anmeldung mit Hilfe des Password Store (setzt –method=sqlplus voraus) </li><li>–mode= Mit dem mode-Parameter teilt man dem Plugin mit, was es tun soll. Siehe Liste der möglichen Werte weiter unten. </li><li>–tablespace=
Hier kann die Prüfung auf einen einzigen Tablespace eingeschränkt
werden. Fehlt dieser Parameter, dann werden sämtliche Tablespaces
geprüft. </li><li>–datafile= Hier
kann die Prüfung auf ein einziges Datafile eingeschränkt werden. Fehlt
dieser Parameter, dann werden sämtliche Datafiles geprüft. </li><li>–name=
Hier kann die Prüfung auf ein einziges Objekt (Latch, Enqueue,
Tablespace, Datafile) eingeschränkt werden. Fehlt dieser Parameter, dann
werden sämtliche Objekte geprüft. (Anstelle von –tablespace oder
–datafile kann und sollte dieser Parameter benutzt werden. Er dient
dazu, die Aufrufschnittstelle des Plugins zu vereinheitlichen). </li><li>–name2=
Verwendet man –mode=sql, dann erscheint das SQL-Statement in der
Ausgabe und den Performancedaten. Mit dem Parameter name2 kann man dafür
einen eigenen String vergeben. </li><li>–regexp Durch diesen Schalter wird der Wert des –name Parameters als regulärer Ausdruck interpretiert. </li><li>–warning= Ermittelte Werte außerhalb dieses Bereichs lösen ein WARNING aus. </li><li>–critical= Ermittelte Werte außerhalb dieses Bereichs lösen ein CRITICAL aus. </li><li>–absolute
Bei im Laufe der Zeit ansteigenden Werten kann der Anstieg pro Sekunde
oder mit dem Parameter –absolute die Differenz zwischen dem jetzigen und
dem letzten Lauf betrachtet werden. </li><li>–runas= Mit diesem Parameter ist es möglich, das Script unter einer anderen Userkennung laufen zu lassen. (Interner Aufruf von sudo -u . </li><li>–environment =
Damit kann man dem Script Environmentvariablen mitgeben. Z.b.
–environment ORACLE_HOME=/u01/oracle. Mehrfachnennungen sind möglich. </li><li>–method= Mit diesem Parameter teilt man dem Plugin mit, wie es sich zur Datenbank verbinden soll. (dbi für Verbindung per DBD::Oracle (default), sqlplus für Verbindung per sqlplus-Aufruf). </li><li>–units=<%|KB|MB|GB>
Die Angabe von Einheiten dient der “Verschönerung” von Ausgaben des
mode=sql und der einfachen Angabe von Schwellwerten bei
mode=tablespace-free </li><li>–dbthresholds Dieser Parameter sorgt
dafür, daß Schwellwerte aus der Datenbanktabelle
check_oracle_health_thresholds gelesen werden </li></ul>

Um dem Plugin mitzuteilen, welche Werte es ermitteln und prüfen soll,
benutzt man die Option –mode mit verschiedenen Schlüsselwörtern.

<table class="nagiosplugins" width="574"><tbody> <tr> <td width="173">Schlüsselwort</td> <td width="249">Bedeutung</td> <td width="150">Wertebereich</td> </tr> <tr> <td width="189">tnsping </td> <td width="265">Listener </td> <td width="150">  </td> </tr> <tr> <td width="189">connection-time</td> <td width="265">Misst, wie lange Verbindungsaufbau und Login dauern</td> <td width="150">0..n Sekunden (1, 5)</td> </tr> <tr> <td width="189">connected-users</td> <td width="265">Die Anzahl der an der Datenbank angemeldeten User</td> <td width="150">0..n (50, 100)</td> </tr> <tr> <td width="189">session-usage</td> <td width="265">Prozentsatz der möglichen Sessions</td> <td width="150">0%..100% (80, 90)</td> </tr> <tr> <td width="189">process-usage</td> <td width="265">Prozentsatz der möglichen Prozesse</td> <td width="150">0%..100% (80, 90)</td> </tr> <tr> <td width="189">rman-backup-problems</td> <td width="265">Anzahl der RMAN-Fehler während der letzten drei Tage</td> <td width="150">0..n (1, 2)</td> </tr> <tr> <td width="189">sga-data-buffer-hit-ratio </td> <td width="265">Hitrate im Data Buffer Cache </td> <td width="150">0%..100% (98:, 95:) </td> </tr> <tr> <td width="189">sga-library-cache-hit-ratio </td> <td width="265">Hitrate im Library Cache </td> <td width="150">0%..100% (98:, 95:) </td> </tr> <tr> <td width="189">sga-dictionary-cache-hit-ratio </td> <td width="265">Hitrate im Dictionary Cache </td> <td width="150">0%..100% (95:, 90:) </td> </tr> <tr> <td width="189">sga-latches-hit-ratio </td> <td width="265">Hitrate der Latches </td> <td width="150">0%..100% (98:, 95:) </td> </tr> <tr> <td width="189">sga-shared-pool-reloads </td> <td width="265">Reload Rate im Shared Pool </td> <td width="150">0%..100% (1, 10) </td> </tr> <tr> <td width="189">sga-shared-pool-free </td> <td width="265">Freier Speicher im Shared Pool </td> <td width="150">0%..100% (10:, 5:) </td> </tr> <tr> <td width="189">pga-in-memory-sort-ratio </td> <td width="265">Prozentsatz der Sorts im Speicher </td> <td width="150">0%..100% (99:, 90:) </td> </tr> <tr> <td width="189">invalid-objects </td> <td width="265">Anzahl fehlerhafter Objekte, Indices, Partitions </td> <td width="150">  </td> </tr> <tr> <td width="189">stale-statistics </td> <td width="265">Anzahl der Objekte mit veralteten Optimizer Statistiken </td> <td width="150">n (10, 100) </td> </tr> <tr> <td width="189">tablespace-usage </td> <td width="265">Verbrauchter Speicherplatz im Tablespace </td> <td width="150">0%..100% (90, 98) </td> </tr> <tr> <td width="189">tablespace-free </td> <td width="265">Freier Speicherplatz im Tablespace </td> <td width="150">0%..100% (5:, 2:) </td> </tr> <tr> <td width="189">tablespace-fragmentation </td> <td width="265">Free Space Fragmentation Index </td> <td width="150">100..1 (30:, 20:) </td> </tr> <tr> <td width="189">tablespace-io-balanc </td> <td width="265">IO-Verteilung unter den Datafiles eines Tablespaces </td> <td width="150">n (1.0, 2.0) </td> </tr> <tr> <td width="189">tablespace-remaining-time </td> <td width="265">Anzahl
der verbleibenden Tage, bis ein Tablespace zu 100% belegt ist. Die
Wachstumsrate wird aus den Daten der letzten 30 Tage berechnet. (mit dem
Parameter –lookback können andere Zeiträume angegeben werden) </td> <td width="150">Tage (90:, 30:) </td> </tr> <tr> <td width="189">tablespace-can-allocate-next </td> <td width="265">Prüft, ob im Tablespace noch genügend Platz für das next Extent ist </td> <td width="150">  </td> </tr> <tr> <td width="189">flash-recovery-area-usage</td> <td width="265">Belegter Speicherplatz in der Flash Recovery Area</td> <td width="150">0%..100% (90, 98)</td> </tr> <tr> <td width="189">flash-recovery-area-free</td> <td width="265">Freier Speicherplatz in der Flash Recovery Area</td> <td width="150">0%..100% (5:, 2:)</td> </tr> <tr> <td width="189">datafile-io-traffic </td> <td width="265">Anzahl der IO-Operationen von Datafiles pro Sekunde </td> <td width="150">n/sec (1000, 5000) </td> </tr> <tr> <td width="189">datafiles-existing</td> <td width="265">Prozentsatz der maximal möglichen Datafiles</td> <td width="150">0%..100% (80, 90)</td> </tr> <tr> <td width="189">soft-parse-ratio </td> <td width="265">Der Anteil der soft-parse-Aufrufe </td> <td width="150">0%..100% </td> </tr> <tr> <td width="189">switch-interval </td> <td width="265">Intervall zwischen RedoLog File Switches </td> <td width="150">0..n Sekunden (600:, 60:) </td> </tr> <tr> <td width="189">retry-ratio </td> <td width="265">Retry-Rate im RedoLog Buffer </td> <td width="150">0%..100% (1, 10) </td> </tr> <tr> <td width="189">redo-io-traffic </td> <td width="265">Redolog IO in MB/sec </td> <td width="150">n/sec (199,200) </td> </tr> <tr> <td width="189">roll-header-contention </td> <td width="265">Rollback Segment Header Contention </td> <td width="150">0%..100% (1, 2) </td> </tr> <tr> <td width="189">roll-block-contention </td> <td width="265">Rollback Segment Block Contention </td> <td width="150">0%..100% (1, 2) </td> </tr> <tr> <td width="189">roll-hit-ratio </td> <td width="265">Rollback Segment gets/waits Ratio </td> <td width="150">0%..100% (99:, 98:) </td> </tr> <tr> <td width="189">roll-extends </td> <td width="265">Rollback Segment Extends </td> <td width="150">n, n/sec (1, 100) </td> </tr> <tr> <td width="189">roll-wraps </td> <td width="265">Rollback Segment Wraps </td> <td width="150">n, n/sec (1, 100) </td> </tr> <tr> <td width="189">seg-top10-logical-reads </td> <td width="265">Anzahl der Userprozesse unter den top 10 logical reads </td> <td width="150">n (1, 9) </td> </tr> <tr> <td width="189">seg-top10-physical-reads </td> <td width="265">Anzahl der Userprozesse unter den top 10 physical reads </td> <td width="150">n (1, 9) </td> </tr> <tr> <td width="189">seg-top10-buffer-busy-waits </td> <td width="265">Anzahl der Userprozesse unter den top 10 buffer busy waits </td> <td width="150">n (1, 9) </td> </tr> <tr> <td width="189">seg-top10-row-lock-waits </td> <td width="265">Anzahl der Userprozesse unter den top 10 row lock waits </td> <td width="150">n (1, 9) </td> </tr> <tr> <td width="189">event-waits </td> <td width="265">Waits/sec von System Events </td> <td width="150">n/sec (10,100) </td> </tr> <tr> <td width="189">event-waiting </td> <td width="265">Wieviel Prozent der verstrichenen Zeit hat ein Event mit Warten verbracht </td> <td width="150">0%..100% (0.1,0.5) </td> </tr> <tr> <td width="189">enqueue-contention </td> <td width="265">Enqueue wait/request-Verhältnis </td> <td width="150">0%..100% (1, 10) </td> </tr> <tr> <td width="189">enqueue-waiting </td> <td width="265">Wieviel Prozent der Zeit seit dem letzten Lauf hat ein Enqueue mit Warten verbracht</td> <td width="150">0%..100% (0.00033,0.0033) </td> </tr> <tr> <td width="189">latch-contention </td> <td width="265">Latch misses/gets-Verhältnis. Mit –name wird ein Latchname oder eine Latchnummer übergeben. (Siehe list-latches) </td> <td width="150">0%..100% (1,2) </td> </tr> <tr> <td width="189">latch-waiting </td> <td width="265">Wieviel Prozent der Zeit seit dem letzten Lauf hat ein Latch mit Warten verbracht</td> <td width="150">0%..100% (0.1,1) </td> </tr> <tr> <td width="189">sysstat </td> <td width="265">Änderung/sec für beliebige Werte aus v$sysstat </td> <td width="150">n/sec (10,10) </td> </tr> <tr> <td width="189">sql </td> <td width="265">Ergebnis
eines beliebigen SQL-Befehls, der eine Zahl zurückliefert. Der Befehl
wird mit dem Parameter –name übergeben. Ein Label für Performancedaten
kann mit dem Parameter –name2 übergeben werden. </td> <td width="150">n (1,5) </td> </tr> <tr> <td width="189">  </td> <td width="265">  </td> <td width="150">  </td> </tr> <tr> <td width="189">list-tablespaces </td> <td width="265">Gibt eine Liste der Tablespaces aus </td> <td width="150">  </td> </tr> <tr> <td width="189">list-datafiles </td> <td width="265">Gibt eine Liste der Datafiles aus </td> <td width="150">  </td> </tr> <tr> <td width="189">list-latches </td> <td width="265">Gibt eine Liste der Latch-Namen und -Nummern aus </td> <td width="150">  </td> </tr> <tr> <td width="189">list-enqueues </td> <td width="265">Gibt eine Liste der Enqueue-Namen aus </td> <td width="150">  </td> </tr> <tr> <td width="189">list-events </td> <td width="265">Gibt
eine Liste der Events aus (v$system_event). Neben event_number/event_id
wird eine verkürzte Form des Eventnamens ausgegeben, die z.b. für
Nagios-Servicedescriptions verwendet werden kann. Bsp: lo_fi_sw_co = log
file switch completion </td> <td width="150">  </td> </tr> <tr> <td width="189">list-background-events </td> <td width="265">Gibt eine Liste der Background-Events aus </td> <td width="150">  </td> </tr> <tr> <td width="189">list-sysstats </td> <td width="265">Gibt eine Liste der systemweiten Statistiken aus </td> <td width="150">  </td> </tr> </tbody></table>

 CREATE USER nagios IDENTIFIED BY oradbmon; GRANT CREATE SESSION TO nagios; GRANT SELECT any dictionary TO nagios; GRANT SELECT ON V_$SYSSTAT TO nagios; GRANT SELECT ON V_$INSTANCE TO nagios; GRANT SELECT ON V_$LOG TO nagios; GRANT SELECT ON SYS.DBA_DATA_FILES TO nagios; GRANT SELECT ON SYS.DBA_FREE_SPACE TO nagios; -- -- falls noch jemand Oracle 8.1.7 einsetzt... GRANT SELECT ON sys.dba_tablespaces TO nagios; GRANT SELECT ON dba_temp_files TO nagios; GRANT SELECT ON sys.v_$Temp_extent_pool TO nagios; GRANT SELECT ON sys.v_$TEMP_SPACE_HEADER  TO nagios; GRANT SELECT ON sys.v_$session TO nagios;   Beispiele   nagios$ check_oracle_health --connect bba --mode tnsping OK - connection established to bba.   nagios$ check_oracle_health --mode connection-time OK - 0.17 seconds to connect  |   connection_time=0.1740;1;5   nagios$ check_oracle_health --mode sga-data-buffer-hit-ratio CRITICAL - SGA data buffer hit ratio 0.99%  |   sga_data_buffer_hit_ratio=0.99%;98:;95:   nagios$ check_oracle_health --mode sga-library-cache-hit-ratio OK - SGA library cache hit ratio 98.75%  |   sga_library_cache_hit_ratio=98.75%;98:;95:   nagios$ check_oracle_health --mode sga-latches-hit-ratio OK - SGA latches hit ratio 100.00%  |   sga_latches_hit_ratio=100.00%;98:;95:   nagios$ check_oracle_health --mode sga-shared-pool-reloads OK - SGA shared pool reloads 0.28%  |   sga_shared_pool_reloads=0.28%;1;10   nagios$ check_oracle_health --mode sga-shared-pool-free WARNING - SGA shared pool free 8.91%  |   sga_shared_pool_free=8.91%;10:;5:   nagios$ check_oracle_health --mode pga-in-memory-sort-ratio OK - PGA in-memory sort ratio 100.00%  |   pga_in_memory_sort_ratio=100.00;99:;90:   nagios$ check_oracle_health --mode invalid-objects OK - no invalid objects found  |   invalid_ind_partitions=0 invalid_indexes=0   invalid_objects=0 unrecoverable_datafiles=0   nagios$ check_oracle_health --mode switch-interval OK - Last redo log file switch interval was 18 minutes |     redo_log_file_switch_interval=1090s;600:;60:   nagios$ check_oracle_health --mode switch-interval --connect rac1 OK - Last redo log file switch interval was 32 minutes (thread 1)|     redo_log_file_switch_interval=1938s;600:;60:   nagios$ check_oracle_health --mode tablespace-usage CRITICAL - tbs SYSTEM usage is 99.33% tbs SYSAUX usage is 93.73% tbs USERS usage is 8.75% tbs UNDOTBS1 usage is 6.65% | 'tbs_users_usage_pct'=8%;90;98 'tbs_users_usage'=0MB;4;4;0;5 'tbs_undotbs1_usage_pct'=6%;90;98 'tbs_undotbs1_usage'=11MB;153;166;0;170 'tbs_system_usage_pct'=99%;90;98 'tbs_system_usage'=695MB;630;686;0;700 'tbs_sysaux_usage_pct'=93%;90;98 'tbs_sysaux_usage'=802MB;770;839;0;856   nagios$ check_oracle_health --mode tablespace-usage     --tablespace USERS OK - tbs USERS usage is 8.75% |   'tbs_users_usage_pct'=8%;90;98   'tbs_users_usage'=0MB;4;4;0;5   nagios$ check_oracle_health --mode tablespace-usage     --name USERS OK - tbs USERS usage is 8.75% |   'tbs_users_usage_pct'=8%;90;98   'tbs_users_usage'=0MB;4;4;0;5   nagios$ check_oracle_health --mode tablespace-free     --name TEST OK - tbs TEST has 97.91% free space left |     'tbs_test_free_pct'=97.91%;5:;2:     'tbs_test_free'=32083MB;1638.40:;655.36:;0.00;32767.98   nagios$ check_oracle_health --mode tablespace-free     --name TEST --units MB --warning 100: --critical 50: OK - tbs TEST has 32083.61MB free space left |     'tbs_test_free_pct'=97.91%;0.31:;0.15:     'tbs_test_free'=32083.61MB;100.00:;50.00:;0;32767.98   nagios$ check_oracle_health --mode tablespace-free     --name TEST --warning 10: --critical 5: OK - tbs TEST has 97.91% free space left |     'tbs_test_free_pct'=97.91%;10:;5:     'tbs_test_free'=32083MB;3276.80:;1638.40:;0.00;32767.98   nagios$ check_oracle_health --mode tablespace-remaining-time     --tablespace ARUSERS --lookback 7 WARNING - tablespace ARUSERS will be full in 78 days |   'tbs_arusers_days_until_full'=78;90:;30:   nagios$ check_oracle_health --mode flash-recovery-area-free OK - flra /u00/app/oracle/flash_recovery_area has 100.00% free space left |     'flra_free_pct'=100.00%;5:;2:     'flra_free'=2048MB;102.40:;40.96:;0;2048.00   nagios$ check_oracle_health --mode flash-recovery-area-free     --units KB --warning 1000: --critical 500: OK - flra /u00/app/oracle/flash_recovery_area has 2097152.00KB free space left |     'flra_free_pct'=100.00%;0.05:;0.02:     'flra_free'=2097152.00KB;1000.00:;500.00:;0;2097152.00   nagios$ check_oracle_health --mode datafile-io-traffic   --datafile users01.dbf WARNING - users01.dbf: 1049.83 IO Operations per Second |   'dbf_users01.dbf_io_total_per_sec'=1049.83;1000;5000   nagios$ check_oracle_health --mode latch-contention   --name 214 OK - SGA latch library cache (214) contention 0.08% |  'latch_214_contention'=0.08%;1;2  'latch_214_sleep_share'=0.00% 'latch_214_gets'=49995   nagios$ check_oracle_health --mode latch-contention   --name 'library cache' OK - SGA latch library cache (214) contention 0.08% |  'latch_214_contention'=0.08%;1;2  'latch_214_sleep_share'=0.00% 'latch_214_gets'=49937   nagios$ check_oracle_health --mode enqueue-contention --name TC CRITICAL - enqueue TC: 19.90% of the requests must wait |  'TC_contention'=19.90%;1;10  'TC_requests'=2015 'TC_waits'=401   nagios$ check_oracle_health --mode latch-contention   --name 'messages' OK - SGA latch messages (17) contention 0.02% |  'latch_17_contention'=0.02%;1;2 'latch_17_gets'=4867   nagios$ check_oracle_health --mode latch-waiting   --name 'user lock' OK - SGA latch user lock (205) sleeping 0.000841% of the time |  'latch_205_sleep_share'=0.000841%   nagios$ check_oracle_health --mode event-waits   --name 'log file sync' OK - log file sync : 1.839511 waits/sec |  'log file sync_waits_per_sec'=1.839511;10;100   nagios$ check_oracle_health --mode event-waiting   --name 'Log file parallel write' OK - log file parallel write waits 0.045843% of the time | rarr 'log file parallel write_percent_waited'=0.045843%;0.1;0.5   nagios$ check_oracle_health --mode sysstat   --name 'transaction rollbacks' OK - 0.000003 transaction rollbacks/sec |  'transaction rollbacks_per_sec'=0.000003;10;100  'transaction rollbacks'=4   nagios$ check_oracle_health --mode sql   --name 'select count(*) from v$session' --name2 sessions CRITICAL - sessions: 21 | 'sessions'=21;1;5   nagios$ check_oracle_health --mode sql   --name 'select 12 from dual' --name2 twelve --units MB CRITICAL - twelfe: 12MB | 'twelfe'=12MB;1;5   nagios$ check_oracle_health --mode sql   --name 'select 200,300,1000 from dual'   --name2 'kaspar melchior balthasar'   --warning 180 --critical 500 WARNING - kaspar melchior balthasar: 200 300 1000 | 'kaspar'=200;180;500 'melchior'=300;; 'balthasar'=1000;;   nagios$ check_oracle_health --mode sql   --name "select 'abc123' from dual" --name2 \\d   --regexp OK - output abc123 matches pattern \d nagios$ check_oracle_health --connect $DBNAME --username $DBUSER --password $DBPWD --mode sql --name2 "mail139part2_service, gb139_service, gb139" --name "select value from v\$parameter where name='service_names'"  --regexp  nagios$ check_oracle_health--connect $DBNAME --username $DBUSER --password $DBPWD --mode sql --name2 "mail1391" --name 'select instance_name from v$instance'  --regexp http://labs.consol.de/lang/de/nagios/check_oracle_health/

页: [1]

Chinaunix's Archiver

check_oracle_health 监控