manuales:nagios:thruk
Diferencias
Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anteriorRevisión previaPróxima revisión | Revisión previa | ||
manuales:nagios:thruk [2015/03/30 14:56] – [Configuración] cayu | manuales: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/ | ||
+ | ^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, | ||
+ | |||
+ | **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, | ||
+ | ^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_max_objects|No crear informes con más equipos/ | ||
+ | ^start_page|Este enlace se utilizará como página de inicio|start_page = / | ||
+ | ^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:// | ||
+ | ^documentation_link|Este enlace es utilizado para acceder a los datos de Documentación|documentation_link = / | ||
+ | ^all_problems_link|Enlace donde se muestran los problemas detectados|all_problems_link = / | ||
+ | ^allowed_frame_links|Patrones de enlaces permitidos a mostrar en el marco de Thruk|allowed_frame_links = http:// | ||
+ | === 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 ' | ||
+ | ^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, | ||
+ | ^use_strict_host_authorization|Configurar para que los usuarios solo vean los hosts/ | ||
+ | ^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 = ./ | ||
+ | ^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 = ./ | ||
+ | ^logo_path_prefix|cambia la ruta de acceso a las imágenes de logotipo. El valor predeterminado es $url_prefix+' | ||
+ | ^physical_logo_path|Ubicación de sus logos en su sistema de archivos. Este directorio debe tener relación con ' | ||
+ | ^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 ' | ||
+ | === 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, | ||
+ | ^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 " | ||
+ | ^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, | ||
+ | ^group_paging_summary|Just like the paging_steps, | ||
+ | ^group_paging_grid|Just like the paging_steps, | ||
+ | |||
+ | === 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 ' | ||
+ | ^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 ' | ||
+ | ^initial_menu_state|Set initial menu state.|closed | ||
+ | < | ||
+ | General | ||
+ | Current_Status = 1 | ||
+ | Reports | ||
+ | System | ||
+ | Bookmarks | ||
+ | </ | ||
+ | ^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 | ||
+ | ^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, | ||
+ | ^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/ | ||
+ | ^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 ' | ||
+ | ^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_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 ' | ||
+ | ^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 / | ||
+ | ^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 ' | ||
+ | ^show_error_reports|Show link to bug reports when internal errors occur. Set to ' | ||
+ | ^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/ | ||
+ | ^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:// | ||
+ | Site http:// | ||
+ | System | ||
+ | Other | ||
+ | </ | ||
+ | |||
+ | === Opciones de conexión === | ||
+ | |||
+ | === Cookie Authentication Settings === | ||
+ | === Command Settings === | ||
+ | === Cron Settings === | ||
+ | === Action Menu Settings === | ||
+ | === Icinga Settings === | ||
+ | === Shinken Settings === | ||
+ | === Other Settings === | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === Component Thruk:: | ||
+ | === 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:: | + | **Thruk:: |
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(/ | use lib qw(/ | ||
$ENV{ CATALYST_CONFIG } = "/ | $ENV{ CATALYST_CONFIG } = "/ | ||
+ | </ | ||
+ | <code perl> | ||
+ | $options = { | ||
+ | verbose | ||
+ | credential | ||
+ | remoteurl | ||
+ | local => 0|1, # local requests only | ||
+ | } | ||
</ | </ | ||
Línea 479: | Línea 635: | ||
} | } | ||
</ | </ | ||
+ | |||
===== 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:// | 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:// | ||
manuales/nagios/thruk.txt · Última modificación: 2015/10/22 14:46 por cayu