Monitoring HCL Domino

Domino Server Configuration

In order to enable HCL Domino monitoring, the following lines need to be added to the notes.ini file:

STATPUB_ENABLE=1
STATPUB_URI=file:///./<your path>/domino_stats.txt
STATPUB_DATA_HEAD={$Newline$"Timestamp.datafile":$Timestamp$,
STATPUB_DATA_TAIL=$Newline$}
STATPUB_METRIC_FORMAT=$Newline$"$Name$":$Value$
STATPUB_DELTA_METRIC_FORMAT=$Newline$"$Name$.rate":$Value$

Agent Configuration

Instana will automatically discover and monitor HCL Domino instances without any agent configuration needed.

In order to filter the monitoring metrics the following configuration can be applied:

com.instana.plugin.domino:
  metrics-include: '.*'  # regex which matches the desired metric names.

Metrics collection

To view the metrics, select Infrastructure in the sidebar of the Instana User interface, click a specific monitored host, and then you can see a host dashboard with all the collected metrics and monitored processes.

Configuration data

  • PID
  • Install Type
  • Kit Type
  • Fault Recovery Build
  • Mail Server
  • Server Key Filename
  • Server Name

Performance metrics

The sensor automatically collects all the metrics exposed by HCL Domino. As HCL Domino can be utilised in many ways, we are providing a list of the most commonly monitored metric groups:

  • Calendar
  • Database
  • Disk
  • Domino Cache
  • HTTP
  • Mail
  • Memory
  • Platform
  • Replica
  • Server

Granularity: 1 minute.

Health signatures

Troubleshooting

Use this troubleshooting entries to help resolve problems that are related to monitoring HCL Domino. An error message with the stated issue type and a brief explanation on what went wrong is displayed on the HCL Domino dashboard in the Instana UI.

Invalid Domino metric file location

Monitoring issue type: Invalid metrics file location

This monitoring issue indicates that the notes.ini file is not detected in the present working directory (PWD). For more information, see Domino Server Configuration.

Metrics include regex does not match any metrics

Monitoring issue type: metrics_include_regex_does_not_match_any_metrics

This monitoring issue indicates that a list of metrics that is returned by HCL Domino does not match with the regex that is specified in the Instana agent configuration. To configure the regular expressions of the Instana agent to match with the list of metric names that is returned by HCL Domino, see Agent Configuration.

Custom events can be used in order to trigger issues or incidents based on defined thresholds of any given entity's individual metrics.