Skip to content

Channel Monitoring


This chapter explains how to enable the channels monitoring service.


The punch platform channel monitoring service is in charge of monitoring all channels running.


The PunchPlatform Channel Monitoring service is a task that is run in the Shiva task scheduler. This requires first to add the following job to the channel channel_structure.json descriptor file:

    "type": "shiva",
    "name": "channels-monitoring",
    "command": "channels-monitoring",
    "args": [
    "resources": [
    "cluster": "common",
    "shiva_runner_tags": [

Along with an channels-monitoring.json file to define your settings. This files contains the following fields:

  "monitoring_interval": 10,
  "elasticsearch": {
    "es_cluster_id": "es_search",
    "es_platform_logs_index": "platform-logs-*",
    "es_topologies_metrics_index": "mytenant-metrics-*"
  "reporters": [
      "type": "elasticsearch",
      "cluster_name": "es_search",
      "index_name": "mytenant-channels-monitoring"

This sample configuration means that all channels will be monitored every 10 seconds.


Remember that if you update your configuration, you must restart your channel and save your configuration.



  • monitoring_interval (integer)

    The interval in seconds between two health check of services.

  • elasticsearch.es_cluster_id (string)

    The cluster where all logs and metrics data are stored.

  • elasticsearch.es_platform_logs_index (string)

    Index where to get logs information.

  • elasticsearch.es_topologies_metrics_index (string array)

    Index where to get metrics information.


  • elasticsearch.credentials (map of credentials)

    This is a map of credentials for one or many ElasticSearch clusters. You will need this extra configuration Opendistro Security is enabled on your platform.

Try It

On a standalone deployment, the Channel monitoring service is included in the configuration of the admin channel. To activate the Channel Monitoring service, you must ensure that the admin channel is started.

channelctl --tenant mytenant start --channel admin