Service definition file (jpc_program-name_service.xml)
- Organization of this page
Format
<service> <id>service-ID</id> <name>display-name-of-the-service</name> <description>description</description> <workingdirectory>working-directory</workingdirectory> <env name="environment-variable-name" value="value"></env> <executable>"program-path"</executable> <arguments>arguments-of-the-program</arguments> <startmode>type-of-startup</startmode> <logpath>log-output-directory</logpath> <log mode="roll-by-size"> <sizeThreshold>log-file-size</sizeThreshold> <keepFiles>Number of log faces</keepFiles> </log> <stoptimeout>Termination timeout period</stoptimeout> </service>
File
-
For a physical host
jpc_program-name_service.xml
jpc_program-name_service.xml.model (model file)
-
For a logical host
jpc_program-name_service_logical-host-name.xml
Storage directory
- ■Integrated agent host
-
-
For a physical host (Model File storage destination)
Agent-path\conf\
-
For Physical host and Logical host (storage destination of definition file)
Agent-path\bin\
-
Description
This is the definition file of the Windows serviced program.
Character code
UTF-8 (without BOM)
Line feed code
CR+LF
When the definitions are applied
If you change <startmode> in the definition file, it will take effect by reinstalling the service. For each JP1/IM agent control base or add-on program service, reinstall the service using the commands listed in the following tables.
Add-on program or JP1/IM agent control base |
Service name |
Command |
---|---|---|
Prometheus server |
jpc_prometheus_server_service.exe |
jpc_prometheus_server_service.exe |
Alertmanager |
jpc_alertmanager_service.exe |
jpc_alertmanager_service.exe |
Windows exporter |
jpc_windows_exporter_service.exe |
jpc_windows_exporter_service.exe |
Blackbox exporter |
jpc_blackbox_exporter_service.exe |
jpc_blackbox_exporter_service.exe |
Yet another cloudwatch exporter |
jpc_ya_cloudwatch_exporter_service.exe |
jpc_ya_cloudwatch_exporter_service.exe |
Promitor |
jpc_promitor_scraper_service.exe |
jpc_promitor_scraper_service.exe |
jpc_promitor_resource_discovery_service.exe |
jpc_promitor_resource_discovery_service.exe |
|
Script exporter |
jpc_script_exporter_service.exe |
jpc_script_exporter_service.exe |
Fluentd |
jpc_fluentd_service.exe |
jpc_fluentd_service.exe |
imagent |
jpc_imagent_service.exe |
jpc_imagent_service.exe |
imagentproxy |
jpc_imagentproxy_service.exe |
jpc_imagentproxy_service.exe |
imagentaction |
jpc_imagentaction_service.exe |
jpc_imagentaction_service.exe |
If you change the <arguments> or <stoptimeout> of File, it is reflected by Restart of theservice.
Information that is specified
Item |
Description |
Changeability |
What You Setup in Your JP1/IM - Agent |
JP1/IM - Agent Defaults Value |
||
---|---|---|---|---|---|---|
<service> |
Configure the service settings. |
-- |
-- |
-- |
||
<id> |
Specify the ID of the service (the ID that Windows uses internally to identify the service) (required). This identifier must be unique among all services installed on the system and must consist entirely of alphanumeric characters. |
N |
-- |
|
||
<name> |
Specify a display name for the service (the short display name of the service) (optional). It can contain spaces and other characters. Do not specify a long string, such as <id>. It must also be unique among all services in a particular system. |
N |
-- |
|
||
<description> |
Specify a description (long description) (optional). This description is displayed in the Windows Service Control Manager when the service is selected. |
N |
-- |
|
||
<workingdirectory> |
Specify the working directory (the current directory of the service). |
N |
-- |
|
||
<env name="environment-variable-name" value="value"> |
Specifies the environment-variable-name and its value. This is specified for Promitor Scraper, Promitor Resource Discovery, and OracleDB exporter. |
|
-- |
|
||
<executable> |
Specify the path of the program (the path of the executable file to be launched) (required). You can specify an absolute path or specify the executable file name to search from PATH. Note, however, that services often run under different user accounts, so they may have a different PATH than the shell. Note that specifying an empty string does not result in an error. |
N |
-- |
|
||
<arguments> |
Specify the program arguments (the arguments to be passed to the executable file to be launched). If you want to change the value, restart the service after changing the value. |
Y |
Change the settings when you want to change the arguments. |
|
||
<startmode> |
Specify the startup type (Windows service start mode) (optional). Specify one of the following values:
If you want to change the value, uninstall the service once, change the value, and then reinstall the service. |
Y |
|
|
||
<logpath> |
Specify the log output destination directory (the directory where the log file will be created). If specified, the directory where the configuration file exists is the default. If you want to change the value, restart the service after changing the value. |
Y |
-- |
Set up automatically during setup. |
||
<log mode="roll-by-size"> |
The log output mode is roll-by-size mode. It operates in the same way as append mode, but if the value set for log file size is exceeded, it will be rolled to myapp.1.out.log, myapp.2.out.log, etc. |
N |
-- |
-- |
||
<sizeThreshold> |
Specify it in KB when changing the log file size (rotation threshold). If you want to change the value, restart the service after changing the value. |
N |
Change Setup when you are prompted to change Value from the support desk. |
10240 |
||
<keepFiles> |
Specify this when changing the number of log planes (the number of role files to keep). A log with the specified number of sides + 1 side is created. If you want to change the value, restart the service after changing the value. Value that can be Setup is 7 to 511. |
Y |
Change Setup when you are prompted to change Value from the support desk. |
7 (99 for Fluentd only) |
||
<stoptimeout> |
Specifies the wait time to stop the service (the maximum amount of time to wait after issuing a stop request to the program before the service is stopped). If you want to change the value, restart the service after changing the value. |
Y |
Change the settings when you want to change the waiting time for an outage. |
|
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
prometheus command options
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
--config.file="jpc_prometheus_server.yml"
Specifies the path to the Prometheus configuration file.
Y
--
--config.file="Agent-path/jp1ima/conf/jpc_prometheus_server.yml"
--web.listen-address="0.0.0.0:9090"
Specify the listening port. If you want to limit the listening IP address, also include the host name or internet address. If you specify a host name, you can specify up to 255 bytes.
<Configuration example>
To accept requests for all IP addresses, set the following:
--web.listen-address="0.0.0.0:20713"
If you want to limit the IP addresses that are accepted, you can specify a host name or an internet address as follows:
--web.listen-address="host-name-or-IP-address:20713"
Y
Specify this when you want to change the port or limit the listening IP address.
--web.listen-address="0.0.0.0:20713"
--web.read-timeout=5m
Specifies the maximum amount of time before reading requests times out and idle connections are closed.
N
--
--web.read-timeout=5m
--web.max-connections=512
Specifies the maximum number of concurrent connections.
N
--
--web.max-connections=10
--web.enable-lifecycle
Specifies to enable shutdown and reload by HTTP request.
N
--
--web.enable-lifecycle
--storage.tsdb.path="data/"
Specify the path where you want to save the performance data.
N
--
--storage.tsdb.path="data/prometheus_server/"
--storage.tsdb.min-block-duration=2h
Specifies the minimum duration of the block.
N
--
--storage.tsdb.min-block-duration=1h
--storage.tsdb.max-block-chunk-segment-size=512MB
Specifies the maximum size of a single chunk segment in a block.
N
--
--storage.tsdb.max-block-chunk-segment-size=32MB
--storage.tsdb.retention.time=STORAGE.TSDB.RETENTION.TIME
Specify the retention period of performance data in hours in the range of 1 to 48h.
<Configuration example>
--storage.tsdb.retention.time=24h
Y
If a range vector selector is used for the alert rule condition, specify a value greater than that range.
--storage.tsdb.retention.time=1h
--storage.remote.flush-deadline=<duration>
Specify the maximum waiting time when stopping when remote lights and alerts cannot be sent.
N
--
--storage.remote.flush-deadline=5s
--rules.alert.for-outage-tolerance=1h
Specifies the maximum Prometheus server outage period for which the alert "pending" state can be restored.
N
--
--rules.alert.for-outage-tolerance=1h
--rules.alert.for-grace-period=10m
Specifies the minimum duration of the "for" state when restored from an alert.
Valid only for alerts that have a longer "for" time than this option.
N
--
--rules.alert.for-grace-period=10m
--log.level=info
Only messages above the specified level are logged.
You can specify one of the following levels: debug, info, warn, or error.
N
Change Setup when you are prompted to change Value from the support desk.
Normally, no change is required.
--log.level=debug
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
alertmanager command options
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
--config.file="jpc_alertmanager.yml"
Specifies the path to the Alertmanager configuration file.
Y
--
--config.file="Agent-path/jp1ima/conf/jpc_alertmanager.yml"
--storage.path="data/"
Specify the path where you want to save the administrative data.
N
--
--storage.path="data/alertmanager/"
--data.retention=120h
Specify the retention period for administrative data.
Silence information and information about alerts that occurred are saved.
N
--
--data.retention=168h
--alerts.gc-interval=30m
Specifies the interval for the Garbage Collection.
N
--
--alerts.gc-interval=30m
--web.listen-address=":9093"
Specify the listen port. If you want to limit IP address to be listened to, also include Host name or IP address. When Host name is specified, up to 255 bytes can be specified.
If you specify Host name or IP address for this option, you must Restart or Prometheus configuration file Prometheus server with the same Host name or IP address for localhost listed in the alerting.alertmanagers.static_configs of Reload (jpc_prometheus_server.yml) alerting.alertmanagers.static_configs on the same host.
<Sample Setup>
To accept requests for all IP address, you can Setup them as follows:
--Web.listen-address=":20714"
If you want to limit IP address accepted, you can limit it by specifying Host name or IP address as follows:
--Web.listen-address = " Host name or IP address : 20714"
Y
Specify this when you want to change the port or limit the listening IP address.
--web.listen-address=":20714"
--web.get-concurrency=0
Specifies the maximum number of GET requests to process simultaneously.
N
--
--web.get-concurrency=0
--web.timeout=0
Specifies the timeout period for HTTP requests.
N
--
--web.timeout=0
--cluster.listen-address="0.0.0.0:9094"
Specify the listen address when running Alertmanager in HA mode. If you set an empty string, HA mode is disabled.
N
--
--cluster.listen-address=""
--log.level=info
Only messages above the specified level are logged.
You can specify one of the following levels: debug, info, warn, or error.
N
Change Setup when you are prompted to change Value from the support desk.
Normally, no change is required.
--log.level=info
--log.format=logfmt
Specifies the output format of log messages.
The available output formats are logfmt or json.
N
--
--log.format=logfmt
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
windows_exporter command options
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
--telemetry.addr
Specify the listening port. If you want to limit the listening IP address, also include the host name or internet address. If you specify a host name, you can specify up to 255 bytes.
If you specify Host name for this option, you must Setup the same Host name as this option to targets of Windows exporter discovery configuration file (jpc_file_sd_config_windows) Windows exporter discovery configuration file on the same host, and Restart or Reload Prometheus server.
If you specify IP address for this option, you must Windows exporter discovery configuration file (jpc_file_sd_config_windows) targets on the same host, Setup Host name that resolves to the same IP address as this option and Restart or Reload Prometheus server.
<Configuration example>
To accept requests for all IP addresses, set the following:
--telemetry.addr=":20717"
If you want to limit the IP addresses that are accepted, you can specify a host name or an internet address as follows:
--telemetry.addr="host name or IP address:20717"
Y
Specify this option if you want to change the port or if you want to limit IP address to be listened to.
--telemetry.addr=":20717"
--config.file
Specifies the path to the Windows exporter configuration file.
Values set in this file are overwritten by command line options.
Y
--
--config.file="Agent-path/jp1ima/conf/jpc_windows_exporter.yml"
--log.level
Only messages above the specified level are logged.
You can specify one of the following levels: debug, info, warn, or error.
N
--
--log.level=debug
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
blackbox_exporter command options
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
--config.file
Specifies the path to the Blackbox exporter configuration file.
Y
--
--config.file="Agent-path/jp1ima/conf/jpc_blackbox_exporter.yml"
--web.listen-address
Specify the listening port. If you want to limit the listening IP address, also include the host name or internet address. If you specify a host name, you can specify up to 255 bytes.
If you specify Host name or IP address for this option, you must Setup and Prometheus server Restart or Reload the same Host name or IP address as this option to Prometheus configuration file (jpc_prometheus_server.yml) on the same host in the relabel_config of scrape jobs for blackbox_exporter (more than one).
<Configuration example>
To accept requests for all IP addresses, set the following:
--web.listen-address=":20715"
If you want to limit the IP addresses that are accepted, you can specify a host name or an internet address as follows:
--web.listen-address="host name or IP address:20715"
Y
Specify this when you want to change the port or limit the listening IP address.
--web.listen-address=":20715"
--timeout-offset
Specifies the number of seconds to subtract from the Prometheus scrape_timeout value.
The Prometheus scrape_timeout value will now time out in seconds minus the value specified for this option.
N
Offset from timeout period (seconds)
--timeout-offset=0.5
--history.limit
Specifies the upper limit of the history of probe results.
This history is stored internally blackbox_exporter, and old history is deleted.
N
Maximum number of items in history
--history.limit=100
--log.level
Only messages above the specified level are logged.
You can specify one of the following levels: debug, info, warn, or error.
N
Change Setup when you are prompted to change Value from the support desk.
Normally, no change is required.
--log.level=info
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
promitor_scraper command options
No specifiable options.
-
promitor_resource_discovery command options
No specifiable options.
-
script_exporter command options
Item
Description
Modifiable
Content set by the user in JP1/IM - Agent
Default value in JP1/IM - Agent
-config.file
Path to configuration file.
Y
--
-
For Windows
installation-directory\jp1ima\conf\jpc_script_exporter.yml
-
For Linux
/opt/jp1ima/conf/jpc_script_exporter.yml
-web.listen-address
Specifies the standby port. To limit IP addresses for listening, also specify the host name and IP address. Host names up to 255 bytes in length can be specified.
Setting example:
To receive requests for all IP addresses, configure the following settings as follows:
--web.listen-address=":9469"
To limit the IP addresses for which requests can be received, specify the host name or IP address as follows:
--web.listen-address="host-name-or-IP-address:9469"
Y
Specify this to change the port, or to limit IP addresses for listening.
20722
-timeout-offset
Offset to subtract from Prometheus-supplied timeout in seconds. (default 0.5)
The system will time out in the sum of the number of seconds specified for this option subtracted from the Prometheus scrape_timeout value.
N
Offset subtracted from the timeout time (seconds)
--timeout-offset=0.5
-
- Legend:
-
Y: Modifiable, N: Not modifiable, --: Not applicable
-
fluentd command options
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
-c
--config.file PATH
Specifies configuration file pathname of Fluentd.
Y
For Logical host, you must modify log monitoring common definition file paths that you place in shared folders on Logical host.
Log monitoring common definition file pass of Fluentd
'-i CONFIG_STRING
--enable-input-metrics
Sets the input plug-in metric for Fluentd to Enable.
N
--
None
-G
--conf-encoding ENCODING
Specifies the encoding of the configuration File.
N
--
UTF-8
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable
-
oracledb_exporter command-option
Item
Description
Changeability
What You Setup in Your JP1/IM - Agent
JP1/IM - Agent Defaults Value
--web.telemetry-path="/metrics"
Specify scrape spacing.
N
--
"/metrics"
--default.metrics="default-metrics.toml"
Specifies the definition file for the default metric.
N
--
"default_metrics.toml"
--custom.metrics=""
Specifies the definition file for the custom metric.
N
--
""
--query.timeout=5
Specifies the timeout period when oracledb_exporter accesses Oracle Database to retrieve information.
Specify in hours from 5 to 60.
<Setting example>
--query.timeout=5
Y
Specify this option when it takes a long time to retrieve data from Oracle Database.
5
--database.maxIdleConns=0
Specifies the maximum number of idle connections.
N
--
1
--database.maxOpenConns=10
Specifies the maximum number of open connections.
N
--
1
--scrape.interval=0s
Specifies the scrape interval.
N
--
0s
--[no-]web.systemd-socket
Specifies if socket-based activation is used.
N
--
Not specified (not used)
--web.listen-address=:9161
Specify the listen port.
If you want to limit which IP addresses are listening, also include the hostname or IP address. When a host name is specified, up to 255 bytes can be specified.
If you specify a host name or IP address for this option, set the host name or IP address specified as an option to the localhost (There are more than one) listed in the relabel_confg of the scrape job for prometheus.yml oracledb_exporter on the same host, and Prometheus server needs to be restarted or reloaded.
<Setting example>
To accept a request for all IP addresses, set as follows.
--web.listen-address=":20729"
If you want to restrict the accepted IP addresses, you can restrict them by hostname or IP addressing as follows:
--web.listen-address="hostname or IP address20729"
Y
Specify this when you want to change the port or when you want to limit IP addresses to be listened to.
--web.listen-address="@@port@@"
--log.level=info
Outputs only messages of the specified level or higher to the log.
One of debug, info, warn, error can be specified.
N
Change the setting when the support desk instructs you to change the value.
Normally, no change is required.
--log.level=info
- Legend:
-
Y: Changeable, N: Not changeable, --: Not applicable