Skip to main content

Celonis Product Documentation

Setting up custom monitoring

By enabling custom monitoring, you can collect monitoring data in a dedicated data pool. This dedicated monitoring data pool allows you to leverage Studio views to monitor your data pipelines.

For a video overview of how you can set up custom monitoring for your data pipeline:

 

After enabling custom monitoring, a data pool titled 'Monitoring Pool' is automatically generated. In this data pool, the system events of your data integration service are collected in four tables, each serving a different use case:

  • Data consumption

  • Data Job executions

  • Data model loads

  • Replication Cockpit executions

Difference between the monitoring data pool and other data pools

The monitoring data pool includes pre-configured transformation tasks and data models to make the data available for analysis. While you can edit the transformation tasks in the monitoring data pool, it differs from other data pools in the following ways:

  • The monitoring data pool doesn't allow any data intake, meaning that data connections, file uploads, data transfer imports, replication cockpit, streaming cockpit, and extractor builder are all disabled for this data pool.

  • The data consumption listed in your monitoring data pool is not included in your utilization storage and is excluded from your data model license calculations.

  • The monitoring data pool can't be copied or exported.

  • You aren't able to copy versions into the monitoring data pool or from the monitoring data pool to another.

  • The monitoring data pool fits ready-to-use Studio views that can be downloaded from the Marketplace. See: Installing custom monitoring views.

As an admin, you can set up custom monitoring from your data pool overview screen.

  1. Click Data - Data Integration.

  2. Click Monitoring.

    monitoring_button.png
  3. Click Enable Custom Monitoring.

    enable_custom_monitoring.png

A new data pool named “Monitoring Pool” is created and automatically fed the data pipeline logs. If you previously enabled custom monitoring and a monitoring data pool already exists, that existing data pool will continue to be used to store logs and no new data pool is created.

Note

The tables of the custom data pipeline monitoring are created with the first events captured after enabling this feature. As such, no past data integration events are captured.

  • The data_consumption_updated_events table is created with the first APC calculation for the team, which can take several days. Until then, the "Data Consumption Monitoring" data job will fail.

  • The replication_execution_finished_events table is created with your first Replication Cockpit Execution. If the Replication Cockpit is not set up, the “Replication Cockpit Monitoring" data job will fail.

Disabling custom monitoring

You can disable your custom monitoring at any time by returning to the Monitoring overview screen and clicking Disable custom monitoring:

disabling_custom_monitoring.png

When you disable custom monitoring, monitoring events are no longer pushed to the monitoring data pool. The monitoring data pool is automatically not deleted, however.

After enabling custom monitoring, you can then install the Monitoring application from the Celonis Marketplace. This provides you with ready-to-use Studio views, acting as a dashboard for your data integration monitoring.

To install your custom monitoring views:

  1. Click Marketplace.

  2. Search for the Monitoring application and click + Get it now.

    get_the_monitoring_application.png
  3. Either select an existing Studio space to install this application to or create a new Studio space.

    For more information about Studio spaces, see: Spaces.

    The monitoring application is installed and your chosen Studio space is displayed. At this stage, the data model associated with the monitoring data pool hasn't been loaded, so you'll see errors in the view.

  4. Click Package Settings - Variables.

    package_settings_-_variables.png
  5. For each of the data model variables listen, click Assign data model and select the monitoring data model you want to use.

    assign_data_models.png
  6. Update the apc_limit and team_url variables which store your team’s APC limit (if applicable) and your team’s URL. These variables are used in the monitoring views to correctly display your teams’ APC usage as percentage and to provide a direct link from the monitoring views to the execution logs in data integration.

    edit_plain_text_variables.png
  7. When you're ready to use your views productively, click Draft - Publish.

    draft_publish.png
  8. Click Apps on the main menu and view your newly configured monitoring application.

    data_pipeline_monitoring.png