<?php

/*
 * Copyright 2005 - 2025 Centreon (https://www.centreon.com/)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * For more information : contact@centreon.com
 *
 */

$help = [];
$help['mc_update'] = dgettext(
    'help',
    'Choose the update mode for the below field: incremental adds the selected values, replacement '
    . 'overwrites the original values.'
);

// Service Configuration
$help['service_alias'] = dgettext('help', 'Name used for service in auto-deploy by template.');
$help['service_description'] = dgettext(
    'help',
    "Name of the service or template. It cannot contain white spaces, or special characters like ~!$%^&*\"|'<>?,()=."
    . ' Each service of an host must have a unique name. The name of a service template must be unique.'
);
$help['use'] = dgettext(
    'help',
    'This is where you specify the name of the template object that you want to inherit properties/variables from. '
    . "Inherited properties doesn't need to be specified again. \"Local\" object variables always take "
    . 'precedence over variables defined in the template object. Objects can inherit properties/variables '
    . 'from multiple levels of template objects. When defining multiple sources, the first template specified '
    . 'takes precedence over the later one, in the case where a property is defined in both.'
);

$help['is_volatile'] = dgettext(
    'help',
    'This directive is used to denote whether the service is "volatile". A volatile service resets its '
    . 'state to OK with every query. Services are normally not volatile.'
);
$help['check_period'] = dgettext(
    'help',
    'Specify the time period during which active checks of this service can be made.'
);
$help['check_command'] = dgettext(
    'help',
    'Specify the command that monitoring engine will run in order to check the status of the service.'
);
$help['check_command_args'] = dgettext('help', 'Specify the parameters for the selected check command here.');

$help['max_check_attempts'] = dgettext(
    'help',
    'Define the number of times that monitoring engine will retry the service check command if it returns any '
    . 'state other than an OK state. Setting this value to 1 will cause monitoring engine to generate an alert '
    . 'without retrying the service check again. (default value: 0)'
);
$help['check_interval'] = dgettext(
    'help',
    'Define the number of "time units" between regularly scheduled checks of the service. With the default '
    . 'time unit of 60s, this number will mean multiples of 1 minute. "Regular" checks are those that occur '
    . 'when the service is in an OK state or when the service is in a non-OK state, but has already been '
    . 'rechecked max_check_attempts number of times. (default value: 5)'
);
$help['retry_interval'] = dgettext(
    'help',
    'Define the number of "time units" to wait before scheduling a re-check for this service after a '
    . 'non-OK state was detected. With the default time unit of 60s, this number will mean multiples of 1 minute. '
    . 'Once the service has been retried max_check_attempts times without a change in its status, it will revert '
    . 'to being scheduled at its "normal" check interval rate. (default value: 1)'
);

$help['active_checks_enabled'] = dgettext(
    'help',
    'Enable or disable active checks (either regularly scheduled or on-demand) of this service here. '
    . 'By default active service checks are enabled.'
);
$help['passive_checks_enabled'] = dgettext(
    'help',
    'Enable or disable passive checks here. When disabled submitted states will be not accepted.'
);

$help['notifications_enabled'] = dgettext('help', 'Specify whether or not notifications for this service are enabled.');
$help['contact_additive_inheritance'] = dgettext(
    'help',
    'When enabled, the contact definition will not override the definitions on template levels, it will be '
    . 'appended instead.'
);
$help['cg_additive_inheritance'] = dgettext(
    'help',
    'When enabled, the contactgroup definition will not override the definitions on template levels, '
    . 'it will be appended instead.'
);
$help['contacts'] = dgettext(
    'help',
    'This is a list of contacts that should be notified whenever there are problems (or recoveries) with '
    . "this host. Useful if you want notifications to go to just a few people and don't want to configure "
    . 'contact groups. You must specify at least one contact or contact group in each host definition '
    . '(or indirectly through its template).'
);
$help['inherit_contacts_from_host'] = dgettext(
    'help',
    "Specify whether or not the service will inherit host's contacts and contactgroups (if no contacts or "
    . 'contactgroups are defined for the service).'
);
$help['use_only_contacts_from_host'] = dgettext('help', 'To fill');
$help['contacts'] = dgettext(
    'help',
    'This is a list of contacts that should be notified whenever there are problems (or recoveries) with '
    . "this service. Useful if you want notifications to go to just a few people and don't want to configure contact "
    . 'groups. You must specify at least one contact or contact group in each service definition '
    . '(or indirectly through its template).'
);
$help['contact_groups'] = dgettext(
    'help',
    'This is a list of contact groups that should be notified whenever there are problems (or recoveries) '
    . 'with this service. You must specify at least one contact or contact group in each service definition.'
);
$help['notification_interval'] = dgettext(
    'help',
    'Define the number of "time units" to wait before re-notifying a contact that this service is still in a '
    . 'warning or critical condition. With the default time unit of 60s, this number will mean multiples of 1 minute. '
    . 'A value of 0 disables re-notifications of contacts about problems for this service - only one problem '
    . 'notification will be sent out. (default value: 30)'
);
$help['notification_period'] = dgettext(
    'help',
    'Specify the time period during which notifications of events for this service can be sent out to contacts. '
    . 'If a state change occurs during a time which is not covered by the time period, no notifications will be sent out.'
);
$help['notification_options'] = dgettext(
    'help',
    'Define the states of the service for which notifications should be sent out. If you specify None as an '
    . 'option, no service notifications will be sent out. If you do not specify any notification options, '
    . 'monitoring engine will assume that you want notifications to be sent out for all possible states.'
);
$help['first_notification_delay'] = dgettext(
    'help',
    'Define the number of "time units" to wait before sending out the first problem notification when this '
    . 'service enters a non-OK state. '
    . 'With the default time unit of 60s, this number will mean multiples of 1 minute. '
    . 'If you set this value to 0, monitoring engine will start sending out notifications immediately.'
);
$help['recovery_notification_delay'] = dgettext(
    'help',
    'Define the number of "time units" to wait before sending out the recovery notification when this '
    . 'service enters an OK state. '
    . 'With the default time unit of 60s, this number will mean multiples of 1 minute. '
    . 'If you set this value to 0, monitoring engine will start sending out notifications immediately.'
);
$help['use_only_contacts_from_host'] = dgettext(
    'help',
    "If this option is enabled, use host's notification parameters instead of service or from  template of "
    . 'service parameters inherited'
);

// Relations
$help['host_templates'] = dgettext(
    'help',
    'When one of these host template is applied to a host, a service will be created based on the current template.'
);
$help['host_name'] = dgettext('help', 'Host(s) to which the service is attached');
$help['hostgroup_name'] = dgettext(
    'help',
    'Specify the hostgroup(s) that this service "runs" on or is associated with. One or more hostgroup(s) '
    . 'may be used instead of, or in addition to, specifying hosts.'
);
$help['servicegroups'] = dgettext(
    'help',
    'Service groups linked to the service.'
);
$help['snmptraps'] = dgettext('help', 'Specify the relation of known SNMP traps to state changes of this service.');

// Data processing
$help['obsess_over_service'] = dgettext(
    'help',
    'This directive determines whether or not checks for the service will be "obsessed" over. '
    . 'When enabled the obsess over service command will be executed after every check of this service.'
);
$help['check_freshness'] = dgettext(
    'help',
    'This directive is used to determine whether or not freshness checks are enabled for this service. '
    . 'When enabled monitoring engine will trigger an active check when last passive result is older than '
    . 'the value defined in the threshold. By default freshness checks are enabled.'
);
$help['freshness_threshold'] = dgettext(
    'help',
    'This directive is used to specify the freshness threshold (in seconds) for this service. '
    . 'If you set this directive to a value of 0, monitoring engine will determine a '
    . 'freshness threshold to use automatically.'
);

$help['flap_detection_enabled'] = dgettext(
    'help',
    'This directive is used to determine whether or not flap detection is enabled for this service. '
    . 'A service is marked as flapping when frequent state changes occur.'
);
$help['low_flap_threshold'] = dgettext(
    'help',
    'Specify the low state change threshold used in flap detection for this service. A service with a state '
    . 'change rate below this threshold is marked normal. '
    . 'By setting the value to 0, the program-wide value will be used.'
);
$help['high_flap_threshold'] = dgettext(
    'help',
    'Specify the high state change threshold used in flap detection for this service. A service with a state '
    . 'change rate above or equal to this threshold is marked as flapping. By setting the value to 0, '
    . 'the program-wide value will be used.'
);

$help['process_perf_data'] = dgettext(
    'help',
    'Specify whether or not the processing of performance data is enabled for this service.'
);

$help['retain_status_information'] = dgettext(
    'help',
    'Specify whether or not status-related information about the service is retained across program restarts. '
    . 'This is only useful if you have enabled state retention using the retain_state_information directive.'
);
$help['retain_nonstatus_information'] = dgettext(
    'help',
    'Specify whether or not non-status information about the service is retained across program restarts. '
    . 'This is only useful if you have enabled state retention using the retain_state_information directive.'
);
$help['stalking_options'] = dgettext('help', 'Define which service states "stalking" is enabled for.');

$help['event_handler_enabled'] = dgettext(
    'help',
    'This directive is used to determine whether or not the event handler for this service is enabled.'
);
$help['event_handler'] = dgettext(
    'help',
    'This directive is used to specify the command that should be run whenever a change in the state of the '
    . 'service is detected (i.e. whenever it changes to non-OK or recovers).'
);
$help['event_handler_args'] = dgettext(
    'help',
    'This parameters are passed to the event handler commands in the same way check command parameters are handled. '
    . 'The format is: !ARG1!ARG2!...ARGn'
);

$help['service_acknowledgement_timeout'] = dgettext(
    'help',
    'Specify a duration of acknowledgement for this service or service depending to this template. '
    . 'If you leave it blank, no timeout will be set.'
);

// Service extended infos
$help['graph_template'] = dgettext(
    'help',
    'The optional definition of a graph template will be used as default graph template for this service.'
);
$help['categories'] = dgettext(
    'help',
    'Host categories linked to the service.'
);

$help['notes_url'] = dgettext(
    'help',
    'Clickable URL displayed in the Notes column of the Resources Status page.'
);
$help['notes'] = dgettext(
    'help',
    'Information note displayed as a tooltip in the Notes column of the Resources Status page.'
);
$help['action_url'] = dgettext(
    'help',
    'Define an optional URL that can be used to provide more actions to be performed on the service. '
    . 'You will see the link to the action URL in the service details.'
);
$help['icon_image'] = dgettext(
    'help',
    'Define the image that should be associated with this service here. This image will be displayed in the '
    . 'various places. The image will look best if it is 40x40 pixels in size.'
);
$help['icon_image_alt'] = dgettext(
    'help',
    'Define an optional string that is used in the alternative description of the icon image.'
);
$help['criticality_id'] = dgettext(
    'help',
    'Service severity level. Can be used to sort alerts in the monitoring menus, including the Resources Status page.'
);
$help['geo_coords'] = dgettext(
    'help',
    'Geographic coordinates to allow Centreon MAP to plot the resource on a geographic view.'
    . " Format: Latitude,Longitude. For example, Paris' coordinates are 48.51,2.20"
);

// Macros
$help['macro'] = dgettext(
    'help',
    'Macros are used as object-specific variables/properties, which can be referenced in commands and '
    . 'extended infos. A Macro named TECHCONTACT can be referenced as $_SERVICETECHCONTACT$.'
);

// unsupported in centreon
$help['display_name'] = dgettext(
    'help',
    'This directive is used to define an alternate name that should be displayed in the web interface '
    . 'for this service. If not specified, this defaults to the value you specify as service description.'
);
$help['flap_detection_options'] = dgettext(
    'help',
    'This directive is used to determine what service states the flap detection logic will use for this service.'
);
$help['initial_state'] = dgettext(
    'help',
    'By default monitoring engine will assume that all services are in OK states when it starts.'
    . 'You can override the initial state for a service by using this directive.'
);

$help['service_activate'] = dgettext(
    'help',
    'This setting determines whether the service must be monitored or not.'
);
