Diferencias

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

--- manuales:nagios:thruk [2015/03/30 14:56] – [Configuración] cayu
+++ manuales:nagios:thruk [2015/04/23 20:13] – [Configuración de Thruk] cayu
@@ Línea 165: / Línea 165: @@
 ===== Configuracion =====
+==== Configuración de Thruk ====
+La configuración de Thruk es principalmente administrada en estos archivos de configuración :
+^thruk.conf|Configuración **default** principal de Thruk|
+^thruk_local.conf|Configuración **local** principal, sobreescribe la **default**|
+^cgi.cfg|Naemon/Nagios cgi.cfg|
+^log4perl.conf|Configuración de logging|
+^menu.conf|Configuración **default** de menú de navegación de Thruk|
+^menu_local.conf|Configuración **local** de menú de navegación, sobreescribe la **default**|
+**thruk.conf**
+El achivos thruk.conf contiene los valores predeterminados. No debería editar este archivo directamente. Se debe sobrescribir la configuración dentro del archivo thruk_local.conf en su lugar.
+**thruk_local.conf**
+El archivo thruk_local.conf es una copia del archivo thruk.conf. Ambos archivos son utilizados por thruk. La idea es que el archivo thruk.conf proporcione los valores predeterminados y el archivo thruk_local.conf reemplace dichos ajustes cuando sea necesario.
+=== Opciones generales ===
+^Valor^Descripción^Ejemplo^
+^title_prefix|Establecer el prefijo de título para todas las urls, esta parte del texto se antepondrá a todos los títulos de las páginas|title_prefix = Prod|
+^use_bookmark_titles|Establece el título de la página con el nombre de un marcador|use_bookmark_titles = 1|
+^use_dynamic_titles|Utiliza títulos de las páginas más descriptivos|use_dynamic_titles = 1|
+^url_prefix|Cambia la ruta URL habitual para Thruk|url_prefix = /|
+^use_timezone|Cambia la zona horaria respecto de la predeterminada. Sólo usar esta opción si hay problemas con la visualización de timestamps|use_timezone = CET|
+^mobile_agent|Especifica los user-agent que se redireccionarán al plugin móvil (si está activado)|mobile_agent=iPhone,Android,IEMobile|
+^default_theme|Tema predeterminado para todos los usuarios|default_theme = Thruk|
+^first_day_of_week|Primer día de la semana. Se utiliza en los reportes \\ Sunday: 0 Monday: 1|first_day_of_week = 0|
+^report_use_temp_files|Reportes grandes usarán archivos temporales para evitar el uso de memoria. Con //report_use_temp_files// se puede ajustar la duración en días del reporte que hará uso de archivos temporales. El valor predeterminado es 14 días, así que por ejemplo el informe //last31days// utilizará archivos temporales, el //thisweek// no. Se puede desactivar ajustando a 0.|report_use_temp_files = 14|
+^report_max_objects|No crear informes con más equipos/servicios que este número. El propósito es no sobrecargar el servidor debido a uso de memoria. Aumente este número si es necesario|report_max_objects = 1000|
+^start_page|Este enlace se utilizará como página de inicio|start_page = /thruk/main.html|
+^home_link|Este enlace se utiliza cada vez que se hace clic en uno de los principales logotipos. Predeterminadamente los logotipos son de Thruk y el enlace le llevará a la página de Thruk|home_link = http://www.thruk.org|
+^documentation_link|Este enlace es utilizado para acceder a los datos de Documentación|documentation_link = /thruk/docs/|
+^all_problems_link|Enlace donde se muestran los problemas detectados|all_problems_link = /thruk/cgi-bin/status.cgi?...|
+^allowed_frame_links|Patrones de enlaces permitidos a mostrar en el marco de Thruk|allowed_frame_links = http://intranet.my-company.com \\ allowed_frame_links = https://wiki.my-company.com|
+=== Opciones de autorización ===
+^Valor^Descripción^Ejemplo^
+^can_submit_commands|Permitir que enviar comandos por defecto para todos los contactos|can_submit_commands = 1|
+^command_disabled|Deshabilitar comandos específicos. Se puede utilizar múltiples veces para deshabilitar varios comandos.\\ El número se puede encontrar en el parámetro CGI 'cmd_typ' en los enlaces de la página de comandos.\\ Se pueden utilizar rangos.|command_disabled = 14\\ command_disabled = 35\\ command_disabled = 17-34,50-65|
+^make_auth_user_lowercase|Convertir nombre de usuario autenticado a minúsculas|make_auth_user_lowercase = 1|
+^make_auth_user_uppercase|Convertir nombre de usuario autenticado a mayúsculas|make_auth_user_uppercase = 1|
+^make_auth_replace_regex|Convertir nombre de usuario autenticado, utilizando expresiones regulares.|Eliminar el @ y todo lo que viene despúes dentro de un nombre de usuario\\ <code perl>make_auth_replace_regex = s/^(.*?)@.*/$1/gmx</code>|
+^use_strict_host_authorization|Configurar para que los usuarios solo vean los hosts/servicios donde estan definidos como contacto|use_strict_host_authorization = 1|
+^csrf_allowed_hosts|Permitir a hosts específicos saltear la protección csrf que requiere la generación de un token para ciertos pedidos POST, como enviar comandos|csrf_allowed_hosts=127.0.0.1\\ csrf_allowed_hosts=192.168.*|
+^max_process_memory|Máxima memoria a utilizar en MB, solo afecta al demonio fcgid|max_process_memory=1000|
+=== Configuración de rutas ===
+^Valor^Descripción^Ejemplo^
+^cgi_cfg|Ruta al archivo cgi.cfg|cgi_cfg = cgi.cfg|
+^log4perl_conf|Archivo de configuración de log4perl|log4perl_conf = ./log4perl.conf|
+^plugin_path|Ruta de acceso a los plugins, no debe ser accesible vía web|plugin_path = ./plugins|
+^themes_path|Ruta de acceso a los temas, no debe ser accesible vía web|themes_path = ./themes|
+^var_path|Ruta del directorio //var// de thruk|var_path = ./var|
+^tmp_path|Ruta del directorio de archivos temporales|tmp_path = /tmp|
+^ssi_path|Ruta donde se encuentran los archivos SSI (Server Side Includes)|ssi_path = ssi/|
+^user_template_path|Directorio adicional de plantillas. Se pueden priorizar fácilmente por sobre las plantillas por default de Thruk.\\ El orden de búqueda es :\\ -> users template path\\ -> themes template path\\ -> plugins template path\\ -> thruks template path|user_template_path = ./my_templates|
+^logo_path_prefix|cambia la ruta de acceso a las imágenes de logotipo. El valor predeterminado es $url_prefix+'thruk/themes/'$current_theme'/images/logos/'|logo_path_prefix = /icons/|
+^physical_logo_path|Ubicación de sus logos en su sistema de archivos. Este directorio debe tener relación con 'logo_path_prefix' dónde 'logo_path_prefix' es la ruta relativa al directorio raíz del servidor web y 'physical_logo_path' es la ruta del sistema de archivos correspondiente.|physical_logo_path = /usr/share/icons/|
+^mode_file|Modo usado para crear o guardar archivos|mode_file = 0660|
+^mode_dir|Modo usado para crear directorios|mode_dir = 0770|
+^resource_file|Establezca un archivo de recursos en general. Se recomienda solo usar esta opción si no hay contraseñas se utilizan en este archivo o en combinación con la opción 'expand_user_macros' que limitará qué macros están expuestos al usuario.|resource_file = /etc/nagios3/resource.cfg|
+=== Opciones de búsqueda ===
+^Valor^Descripción^Ejemplo^
+^use_new_search|The new search supports regular expressions and searches in many attributes. For example: plugin_output, groups, names, descriptions|use_new_search = 1|
+^default_service_filter|Set a default service filter which is used when no other filter is applied (except from links to hosts or groups). The filter is negated by a leading exclamation mark. The example filters out all services starting with "test_". You can use regular expressions. The Default is not set.|default_service_filter = !<html>^</html>test_|
+^use_ajax_search|Enables the ajax search field. There will be suggestions while typing into the search field.|use_ajax_search = 1|
+^ajax_search_hosts|Enables the suggestion of hosts in the ajax search field. Depending on the number of hosts, this can make the search slow.|ajax_search_hosts = 1|
+^ajax_search_hostgroups|Enables the suggestion of hostgroups in the ajax search field.|ajax_search_hostgroups = 1|
+^ajax_search_services|Enables the suggestion of services in the ajax search field. Depending on the number of services, this can make the search slow.|ajax_search_services = 1|
+^ajax_search_servicegroups|Enables the suggestion of servicegroups in the ajax search field.|ajax_search_servicegroups = 1|
+^ajax_search_timeperiods|Enables the suggestion of timeperiods in the ajax search field. Timeperiods will only displayed when filtering by check- or notification period.|ajax_search_timeperiods = 1|
+=== Opciones de paginación ===
+^use_pager|Using the pager will make huge pages much faster as most people don’t want a services page with 100.000 services displayed. Can be disabled if you don’t need it.|use_pager = 1|
+^paging_steps|Define the selectable paging steps. Use the * to set the default selected value.|paging_steps = *100, 500, 1000, all|
+^group_paging_overview|Just like the paging_steps, but only for the groups overview page.|group_paging_overview =  *3,  10, 100, all|
+^group_paging_summary|Just like the paging_steps, but only for the groups summary page.|group_paging_summary = *10, 50, 100, all|
+^group_paging_grid|Just like the paging_steps, but only for the groups grip page.|group_paging_grid = *5,  10, 50,  all|
+=== Opciones de pantalla ===
+^host_action_icon|Change path to your host action icons. You may use relative paths to specify completely different location. You also may want to use 'action_pnp.png' when using pnp. Icon can be overridden by a custom variable '_ACTION_ICON'.|host_action_icon = action.gif|
+^service_action_icon|Change path to your service action icons. You may use relative paths to specify completely different location. You also may want to use 'action_pnp.png' when using pnp. Icon can be overridden by a custom variable '_ACTION_ICON'.|service_action_icon = action.gif|
+^initial_menu_state|Set initial menu state.|closed  => 0\\ open    => 1<code>
+<initial_menu_state>
+  General        = 1
+  Current_Status = 1
+  Reports        = 1
+  System         = 1
+  Bookmarks      = 1
+</initial_menu_state></code>|
+^use_frames|Set whether you want to use a framed navigation or not. With using frames it’s sometimes easier to include addons. See allowed_frame_links option for how to integrate addons.|use_frames = 0|
+^use_new_command_box|Show the new split command box on the host / service details page.|use_new_command_box = 1|
+^bug_email_rcpt|what email address bug reports will be sent to|bug_email_rcpt = bugs@thruk.org|
+^datetime_format|Default timeformat. Use POSIX format.|datetime_format = %Y-%m-%d  %H:%M:%S|
+^datetime_format_long|Default long timeformat.|datetime_format_long = %a %b %e %H:%M:%S %Z %Y|
+^datetime_format_log|Default log timeformat.|datetime_format_log = %B %d, %Y  %H|
+^datetime_format_trends|Default trends timeformat.|datetime_format_trends = %a %b %e %H:%M:%S %Y|
+^datetime_format_today|Default timeformat for todays date. Can be useful if you want a shorter date format for today.|datetime_format_today = %H:%M:%S|
+^info_popup_event_type|On which event should the comments / downtime or longpluginoutput popup show up. Valid values are onclick or onmouseover.|info_popup_event_type = onmouseover|
+^info_popup_options|Options for the popup window used for long pluginoutput, downtimes and comments.\\ See http://www.bosrup.com/web/overlib/?Command_Reference for what options are available|info_popup_options = STICKY,CLOSECLICK,HAUTO,MOUSEOFF|
+^show_notification_number|Display the current number of notification after the current / max attempts on the status details page.|show_notification_number = 0|
+^show_backends_in_table|Display the backend/site name in the status table. This is useful if you have same hosts or services on different backends and need to know which one returns an error.|Valid values are:\\ 1 - show site name at the end\\ 2 - put site name in front\\ \\ show_backends_in_table = 0|
+^show_config_edit_buttons|Show links to config tool for each host / service. You need to have the config tool plugin enabled and you need proper permissions for the link to appear.|show_config_edit_buttons = 1|
+^show_full_commandline|Display the full command line for host / service checks . Be warned, the command line could contain passwords and other confidential data. In order to replace the user macros for commands, you have to set the 'resource_file' in your peer config or a general resource_file option.\\ 0 = off, don’t show the command line at all\\ 1 = show them for contacts with the role: authorized_for_configuration_information \\ 2 = show them for everyone|show_full_commandline = 0\\ show_full_commandline_source|
+=== Opciones de conexión ===
+==== Configuración de CGI ====
 ===== FAQ =====
 ===== Plugins =====
@@ Línea 303: / Línea 411: @@
 ==== Server Side Includes ====
 ==== CLI & Scripting ====
+=== Herramienta de línea de comandos ===
 **thruk** - Utilidad de línea de comandos para la GUI de Monitoreo Thruk
@@ Línea 339: / Línea 448: @@
 ==== Benchmarks ====
 ==== API ====
-Thruk::Utils::CLI - Utilidades Colección de secuencias de comandos CLI. Permiten acceder a las estructuras internas y cambiar la información de configuración.
+**Thruk::Utils::CLI** - Utilidades Colección de secuencias de comandos CLI. Permiten acceder a las estructuras internas y cambiar la información de configuración.
 Rutas de búsqueda de librerias para el paquete Thruk :
@@ Línea 355: / Línea 464: @@
 use lib qw(/usr/share/thruk/lib /usr/share/thruk/plugins/plugins-available/conf/lib /usr/lib/thruk/perl5);
 $ENV{ CATALYST_CONFIG } = "/etc/thruk";
+</code>
+<code perl>
+$options = {
+    verbose         => 0-2,         # be more verbose
+    credential      => 'secret',    # secret key when accessing remote instances
+    remoteurl       => 'url',       # url where to access remote instances
+    local           => 0|1,         # local requests only
+ }
 </code>
@@ Línea 478: / Línea 595: @@
     print "\n";
 }
+</code>
+=== Monitoring::Livestatus ===
+API de Perl para acceder a datos Nagios e Icinga por medio de check_mk livestatus
+<code perl>
+use Monitoring::Livestatus;
+    my $ml = Monitoring::Livestatus->new(
+      socket => '/var/lib/livestatus/livestatus.sock'
+    );
+    my $hosts = $ml->selectall_arrayref("GET hosts");
+</code>
+== new ([ARGS]) ==
+Creates an Monitoring::Livestatus object. new takes at least the socketpath. Arguments are in key-value pairs.
+Crea el objeto Monitoring::Livestatus. Toma la ruta del socket.
+^Argumentos^^
+^socket|Ruta al socket UNIX de check_mk livestatus|
+^server|Usar este servidor para una conexión TCP|
+^peer|Camino alternativo al socket o servidor, si se usa el valor ':' va a ser usado servidor sino socket|
+^name|Nombre para la conexión, default dirección socket/server|
+^verbose|Modo verbose|
+^line_seperator|Código ascii separador de líneas default 10, (newline)|
+^column_seperator|Código ascii separador de columnas, defaults 0 (null byte)|
+^list_seperator|Código ascii separador de listas, default 44 (comma)|
+^host_service_seperator|Código ascii separador host/service, default 124 (pipe)|
+^keepalive|keepalive. Default off|
+^errors_are_fatal|Errores con mensaje de caída. Default: on|
+^warnings|muestran advertencias en las consultas sin Columnas|
+^timeout|Tiempo de espera general. Usado para conexión y consultas|
+^query_timeout|set a query timeout. Used for retrieving querys, Default 60sec|
+^connect_timeout|Tiempo de espera de conexión inicial. Por defecto 5 s|
+== Limit ==
+<code perl>
+my $array_ref = $ml->selectcol_arrayref(
+       "GET hosts\nColumns: name contacts",
+       { Limit => "10,20" }
+    );
+</code>
+== Otros ejemplos ==
+<code perl>
+#!/usr/bin/perl
+use Monitoring::Livestatus;
+$filtergrp = 'NAGIOS_ARGENTINA';
+$ml = Monitoring::Livestatus->new(
+	socket => '/usr/local/nagios/var/rw/live'
+);
+my $up = $ml->selectscalar_value("GET hosts\nFilter: host_groups >= $filtergrp\nStats: state = 0");
+my $down = $ml->selectscalar_value("GET hosts\nFilter: host_groups >= $filtergrp\nStats: state = 1");
+my $unknown = $ml->selectscalar_value("GET hosts\nFilter: host_groups >= $filtergrp\nStats: state = 2");
+my $total = $up + $down + $unknown;
+print "$down\/$total \n";
 </code>
 ===== Acerca de la Guía =====
 Esta guía **no oficial** esta inspirada en la documentación original de Thruk. Está pensada para ir presentando casos de uso que se van dando en la operatoria día a dia.
+En principio es casi una copia de la original, con algunas partes traducidas y otras no. La idea es que con el tiempo y poniendo códigos y experiencias personales.
 Thruk es un proyecto muy bueno que me ayuda en mostrar mi trabajo día a día y tiene una comunidad muy activa. Si estas leyendo esto y estas siendo beneficiado por Thruk, te invito a realizar una [[http://www.thruk.org/donate.html|donación al proyecto]]