Herramientas de usuario

Herramientas del sitio


manuales:nagios:thruk

Diferencias

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

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión
Revisión previa
manuales:nagios:thruk [2015/03/30 14:56] – [Configuración] cayumanuales:nagios:thruk [2015/10/22 14:46] (actual) – [API] cayu
Línea 165: Línea 165:
  
 ===== Configuracion ===== ===== 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|Usually the source of your expanded check_command should be the check_command attribute of your host / service. But under certain circumstances you might want to use display expanded commands from a custom variable. In this case, set 'show_full_commandline_source' to '_CUST_VAR_NAME'.|show_full_commandline_source = check_command|
 +^show_logout_button|Show additional logout button next to the top right preferences button. (works only together with cookie authentication)|show_logout_button=1|
 +^show_long_plugin_output|When a plugin returns more than one line of output, the output can be displayed directly in the status table, as popup or not at all. Choose between popup, inline and off|show_long_plugin_output = popup|
 +^status_color_background|Color complete status line with status colour or just the status itself.|status_color_background=0|
 +^show_modified_attributes|Show if a host / service has modified attributes.|show_modified_attributes = 1|
 +^show_host_attempts|Show check attempts for hosts too. The default is to show them on the problems page only. Use this value to force a value.|show_host_attempts = 1|
 +^perf_bar_mode|This option enables a performance bar inside the status/host list which create a graph from the performance data of the plugin output. Available options are 'match', 'first', 'all', 'worst' and 'off'.\\ match: try to set graph which matches the output\\ all: graph all performance values available\\ first: graph only the first performance value\\ worst: graph only the graph for the worst state\\ off: graph no value at all|perf_bar_mode = match|
 +^perf_bar_pnp_popup|Show pnp popup if performance data are available and pnp is used as graph engine.|perf_bar_pnp_popup = 1|
 +^shown_inline_pnp|Show inline pnp graph if available. If a service or host has a pnp4nagios action or notes url set.\\ Thruk will show a inline graph on the extinfo page.\\ This works for /pnp4nagios/ urls and /pnp/.|shown_inline_pnp = 1|
 +^graph_word|graph_word is a regexp used to display any graph on the details page. if a service or host has a graph url in action url (or notes url) set it can be displayed by specifying a regular expression that always appears in this url. You can specify multiple graph_words.When using pnp4nagios, no graph_word is required, just keep it empty.|graph_word = /render/ # for graphite|
 +^show_custom_vars|Show custom vars in host / service ext info. List variable names to display in the host and service extinfo details page. Can be specified more than once to define multiple variables. You may use html in your variables. Use * as wildcard, ex.: _VAR*|show_custom_vars = _VAR1|
 +^expand_user_macros|Expand user macros ($USERx$) for host / service commands and custom variables.\\ Can be specified more than once to define multiple user macros to expand.\\ Be warned, some user macros can contain passwords and expanding them could expose them to unauthorized users. Use * as wildcard, ex.: USER*\\ Defaults to 'ALL' which means all user macros are expanded, because its limited to admin users anyway.|expand_user_macros = USER1\\ expand_user_macros = USER10-20\\ expand_user_macros = PLUGIN*\\ expand_user_macros = ALL  # expands all user macros\\  expand_user_macros = NONE # do not expand user macros|
 +^show_error_reports|Show link to bug reports when internal errors occur. Set to '1' to show a error icon which links to a error report mail. Set to 'server' to log js error server side. Set to 'both' to log server side but still show the icon.|show_error_reports = both|
 +^skip_js_errors|don’t report some known harmless javascript errors|skip_js_errors = cluetip is not a function|
 +^strict_passive_mode|Normally passive checks would be marked as disabled.\\ With this option set, disabled checks will only be displayed as disabled if their last result was active. Otherwise they would be marked as passive checks.\\ This option also changes the passive icon only to be shown when the last check was passive, otherwise the disabled icon will be displayed.|strict_passive_mode = 1|
 +^hide_passive_icon|Normally passive checks whould be displayed with a passive icon if their last result is passive. With this option, passive icon will be hidden in status details.|hide_passive_icon = 0|
 +^sitepanel|The sitepanel is used to display multiple backends/sites at a glance. With than 10 or more sites, the list of backends will be combined into the 'compact' site panel which just displays the totals of available / down / disabled sites. The 'compact' panel will also automatically be used if you use sections. With more than 50 backends, the 'collapsed' will be selected in 'auto' mode. Set sitepanel to list/compact/collapsed/auto/off to change the default behaviour.|sitepanel = auto|
 +^apache_status|You can integrate the output of apache status into Thruk. The following list of apache status pages will be accessible from the performance info page.\\ Make sure the page is accessible from Thruk, credentials will be passed through. So both, basic authentication or ip based authentication would be possible.\\ Read more about Apaches mod_status here: http://httpd.apache.org/docs/current/mod/mod_status.html|<code><apache_status>
 +  Site        http://127.0.0.1:5000/server-status
 +  System      http://127.0.0.1/server-status
 +  Other       http://127.0.0.1/server-status
 +</apache_status></code>|
 +
 +=== Opciones de conexión ===
 +
 +=== Cookie Authentication Settings ===
 +=== Command Settings ===
 +=== Cron Settings ===
 +=== Action Menu Settings ===
 +=== Icinga Settings ===
 +=== Shinken Settings ===
 +=== Other Settings ===
 +=== Component Thruk::Backend ===
 +=== Component Thruk::Plugin::ConfigTool ===
 +=== Component Thruk::Plugin::Panorama ===
 +=== Component Thruk::Plugin::Reports2 ===
 +=== Component Thruk::Plugin::Statusmap ===
 +=== Component Thruk::Plugin::Minemap ===
 +=== Component Thruk::Plugin::BP ===
 +=== User & Group Specific Overrides ===
 +
 +
 +==== Configuración de CGI ====
 +
 ===== FAQ ===== ===== FAQ =====
 ===== Plugins ===== ===== Plugins =====
Línea 303: Línea 450:
 ==== Server Side Includes ==== ==== Server Side Includes ====
 ==== CLI & Scripting ==== ==== CLI & Scripting ====
 +=== Herramienta de línea de comandos ===
 **thruk** - Utilidad de línea de comandos para la GUI de Monitoreo Thruk **thruk** - Utilidad de línea de comandos para la GUI de Monitoreo Thruk
  
Línea 339: Línea 487:
 ==== Benchmarks ==== ==== Benchmarks ====
 ==== API ==== ==== 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 : Rutas de búsqueda de librerias para el paquete Thruk :
Línea 355: Línea 503:
 use lib qw(/usr/share/thruk/lib /usr/share/thruk/plugins/plugins-available/conf/lib /usr/lib/thruk/perl5); use lib qw(/usr/share/thruk/lib /usr/share/thruk/plugins/plugins-available/conf/lib /usr/lib/thruk/perl5);
 $ENV{ CATALYST_CONFIG } = "/etc/thruk"; $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> </code>
  
Línea 479: Línea 635:
 } }
 </code> </code>
 +
 ===== Acerca de la Guía ===== ===== 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.+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]] 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]]
  
manuales/nagios/thruk.1427727409.txt.gz · Última modificación: 2015/03/30 14:56 por cayu