Diferencias

Muestra las diferencias entre dos versiones de la página.

--- manuales:nagios:capacitacion:tipos_de_notificaciones [2015/09/15 12:01] – creado cayu
+++ manuales:nagios:capacitacion:tipos_de_notificaciones [2018/07/24 15:56] – [WhatsApp (Dependencia externa sin garantía)] cayu
@@ Línea 1: / Línea 1: @@
 ====== Tipos de notificaciones ======
+==== Definiciones previas  ====
+  * **Indicador**: //Dato o información que sirve para conocer o valorar las características y la intensidad de un hecho o para determinar su evolución futura.//
+  * **Alerta**: //Señal o aviso con el objetivo de desviar la atención hacia el dato obtenido del indicador.//
+  * **Notificación**: //Hacer saber una cosa a alguien siguiendo ciertas formalidades.//
+  * **Criterio**: //Opinión, juicio o decisión que se adopta sobre una cosa.//
 ===== Correo electrónico =====
+Para el envío de notificaciones por parte de Nagios es necesario configurar un MTA (Agente de Transporte de Correos), por lo general suele estar previamente configurado el Sendmail en el caso de que nos basemos en un CentOS, o un Postifx tratándose de un SuSE o Debian.
+En caso de que utilizemos el paquete de Postfix disponible en la distribución, y debamos utilizar otro servidor saliente SMTP dentro de la red, deberemos configurar el relayhost apuntando al servidor SMTP de la red local ej 192.168.1.110, quedando el archivo /etc/postfix/main.cf con las siguientes entradas de configuración.
+<code>
+queue_directory = /var/spool/postfix
+command_directory = /usr/sbin
+daemon_directory = /usr/lib/postfix
+mail_owner = postfix
+myhostname = nagios
+mydomain = midominio.net
+inet_interfaces = $myhostname
+unknown_local_recipient_reject_code = 550
+debug_peer_level = 2
+debugger_command =
+         PATH=/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin
+         xxgdb $daemon_directory/$process_name $process_id & sleep 5
+sendmail_path = /usr/sbin/sendmail
+newaliases_path = /usr/bin/newaliases
+mailq_path = /usr/bin/mailq
+setgid_group = maildrop
+html_directory = /usr/share/doc/packages/postfix/html
+manpage_directory = /usr/share/man
+sample_directory = /usr/share/doc/packages/postfix/samples
+readme_directory = /usr/share/doc/packages/postfix/README_FILES
+mail_spool_directory = /var/mail
+canonical_maps = hash:/etc/postfix/canonical
+virtual_maps = hash:/etc/postfix/virtual
+relocated_maps = hash:/etc/postfix/relocated
+transport_maps = hash:/etc/postfix/transport
+sender_canonical_maps = hash:/etc/postfix/sender_canonical
+masquerade_exceptions = root
+masquerade_classes = envelope_sender, header_sender, header_recipient
+program_directory = /usr/lib/postfix
+inet_interfaces = 192.168.1.4
+masquerade_domains =
+mydestination = $myhostname, localhost.$mydomain
+defer_transports =
+disable_dns_lookups = no
+relayhost = 192.168.1.110
+content_filter =
+mailbox_command =
+mailbox_transport =
+smtpd_sender_restrictions = hash:/etc/postfix/access
+smtpd_client_restrictions =
+smtpd_helo_required = no
+smtpd_helo_restrictions =
+strict_rfc821_envelopes = no
+smtpd_recipient_restrictions = permit_mynetworks,reject_unauth_destination
+smtp_sasl_auth_enable = no
+smtpd_sasl_auth_enable = no
+smtpd_use_tls = no
+smtp_use_tls = no
+alias_maps = hash:/etc/aliases
+mailbox_size_limit = 0
+message_size_limit = 10240000
+</code>
+Siendo los parámetros : **inet_interfaces** //la ip propia por cual salir, si tenemos una sola placa de red, pondremos esa ip//, **relayhost** //es el host que nos realizará el envío SMTP//.
 ===== SMS =====
+Podemos configurar alertas SMS de forma muy simple con el software Gnokii.
+Ejemplo de archivo de configuración de Gnokii
+<code ini>
+[global]
+port = /dev/ttyUSB2
+model = AT
+initlength = default
+connection = serial
+use_locking = yes
+serial_baudrate = 19200
+smsc_timeout = 10
+[connect_script]
+TELEPHONE = 12345678
+[disconnect_script]
+[fake_driver]
+[flags]
+[gnokii]
+[gnokiid]
+[logging]
+debug = on
+rlpdebug = off
+xdebug = off
+</code>
+Modo de uso :
+**echo "Hola mundo" | sudo gnokii --sendsms 1155667798**
+Definición como comando de notificación, (podemos agregarlo como comando extra al contacto, para que ademas del comando común de notificación por email tambien se ejecute este para el envío de la alerta por sms).
+Notemos que lo ejecutamos por ssh, es para una situación hipotética de que el modem USB 3G de nuestro proovedor de telefonía celular este enchufado en otra maquina de nuestra red.
+<code>
+define command {
+ command_name    host-notify-by-sms
+ command_line    ssh nagios@10.15.99.11 "echo "Host '$HOSTNAME$' esta $HOSTSTATE$ $HOSTOUTPUT$" | sudo gnokii --sendsms $CONTACTPAGER$"
+}
+</code>
+<code>
+define command {
+ command_name    service-notify-by-sms
+ command_line    ssh nagios@10.15.99.11 "echo 'Servicio $SERVICEDESC$ en Host $HOSTNAME$ IP $HOSTADDRESS$ State $SERVICESTATE$ Info $SERVICEOUTPUT$' | sudo gnokii --sendsms $CONTACTPAGER$"
+}
+</code>
+{{ :manuales:nagios:nagios_sms.png |}}
+{{:manuales:nagios:nagios_sms.svg.gz|}}
 ===== WhatsApp (Dependencia externa sin garantía) =====
+  * https://github.com/tgalal/yowsup
+===== Telegram =====
+<code python>
+#!/usr/bin/env python
+import argparse
+from twx.botapi import TelegramBot
+def parse_args():
+    parser = argparse.ArgumentParser(description='Nagios notification via Telegram')
+    parser.add_argument('-t', '--token', nargs='?', required=True)
+    parser.add_argument('-o', '--object_type', nargs='?', required=True)
+    parser.add_argument('--contact', nargs='?', required=True)
+    parser.add_argument('--notificationtype', nargs='?')
+    parser.add_argument('--hoststate', nargs='?')
+    parser.add_argument('--hostname', nargs='?')
+    parser.add_argument('--hostaddress', nargs='?')
+    parser.add_argument('--servicestate', nargs='?')
+    parser.add_argument('--servicedesc', nargs='?')
+    parser.add_argument('--output', nargs='?')
+    args = parser.parse_args()
+    return args
+def send_notification(token, user_id, message):
+    bot = TelegramBot(token)
+    bot.send_message(user_id, message).wait()
+def host_notification(args):
+    state = ''
+    if args.hoststate == 'UP':
+        state = u'\U00002705 '
+    elif args.hoststate == 'DOWN':
+        state = u'\U0001F525 '
+    elif args.hoststate == 'UNREACHABLE':
+        state = u'\U00002753 '
+    return "%s%s (%s): %s" % (
+        state,
+        args.hostname,
+        args.hostaddress,
+        args.output,
+    )
+def service_notification(args):
+    state = ''
+    if args.servicestate == 'OK':
+        state = u'\U00002705 '
+    elif args.servicestate == 'WARNING':
+        state = u'\U000026A0 '
+    elif args.servicestate == 'CRITICAL':
+        state = u'\U0001F525 '
+    elif args.servicestate == 'UNKNOWN':
+        state = u'\U00002753 '
+    return "%s%s/%s: %s" % (
+        state,
+        args.hostname,
+        args.servicedesc,
+        args.output,
+    )
+def main():
+    args = parse_args()
+    user_id = int(args.contact)
+    if args.object_type == 'host':
+        message = host_notification(args)
+    elif args.object_type == 'service':
+        message = service_notification(args)
+    send_notification(args.token, user_id, message)
+if __name__ == '__main__':
+    main()
+</code>
+  * https://github.com/pommi/telegram_nagios
 ===== Visual general =====
+En determinadas situaciones necesitamos visualizar información de forma simple, para poder comunicar a personal no técnico y que dicha información sea exacta, clara y veraz. La finalidad principal de esto, es que todos el que visualice dicha información se de por notificado de la situación que se presenta.
+Los datos suministrados deben ser fáciles de identificar y preferentemente deben estar asociados a un servicio que puedan individualizar todos o la mayoria de los miembros de la organización.
+La mayoría de las organizaciones optan por una pantalla gigante en la cual, quien pase frente a ella se de por anoticiado de la situación actual.
+Para cumplir eficazmente con el objetivo de notificar la información a todos los miembros de la organización, el lenguaje visual debe ser claro y preciso. Se deben omitir todos los detalles irrelevantes para el usuario no ténico y se deben proveer informaciones relevantes, como ubicación geográfica, servicios afectados, y datos de contacto en sitio.
+{{ :manuales:nagios:screen_nagios.png?680 |}}
+{{ :manuales:nagios:screen_nagvis.png?680 |}}