If you require telemetry that is not included in the default out-of-the-box Crosswork Assurance offering, this article outlines the steps to build a custom Telemetry Collector for your use case.
Out-of-the-box vs. Custom Telemetry
Crosswork Assurance provides default Telemetry Collector configurations for IOS-XE and IOS-XR routers via MDT Dial Out. This guide covers customizing the default Telegraf configuration to collect additional sensor paths and metrics. For gNMI Dial In connectivity, the same steps apply, however the Telegraf configuration requires additional modifications.
For custom telemetry ingestion engagements, contact your Cisco CX or Partner representative.
At a Glance
- Create a default Telemetry Collector for your router (to use as a starting point).
- Edit the default configuration to collect the sensor paths/metrics of interest.
- Update the Telemetry Collector with your updated Telegraf configuration.
- Deploy the Telemetry Collector and a Sensor Collector to start data flow to Crosswork Assurance.
- Leverage the Ingestion Staging feature to edit and curate the incoming telemetry to meet your specific needs.
Prerequisites
- The Ingestion Staging feature must be turned on in Crosswork Assurance. This feature is used in the final step of the procedure.
- Access to the Crosswork Assurance UI with permissions to create Telemetry Collector configurations.
Step 1: Create the Default Out-of-the-Box Configuration
Follow the configuration instructions in Configure Telemetry Collector, and choose either XR or XE based on your router type.
Step 2: Edit the Default Configuration to Collect Sensor Paths/Metrics of Interest
Download the Default Telegraf Configuration
- In the Crosswork Assurance UI, navigate to Sensors > Collectors > Telemetry Collectors.
- From the list, select the XE or XR Telemetry Collector that you created in Step 1. A side panel appears.
- Click the download icon to get a local copy of the Telegraf configuration file.
(2).png?sv=2026-02-06&spr=https&st=2026-11-19T02%3A13%3A27Z&se=2026-11-19T02%3A25%3A27Z&sr=b&sp=r&sig=M4wP2mzcN%2FretUSQp5y3Ct8CFukxprc30mw%2Flfr3IY4%3D)
Edit the Telegraf Configuration
Using your preferred editor, edit the Telegraf configuration file to bring in the desired sensor path metrics.
Note: The default Telegraf configuration works for MDT Dial Out. If you require gNMI Dial In, the Telegraf configuration must be updated to establish that connectivity.
This article does not provide instructions on how to write your Telegraf changes. Telegraf is an open source tool and there are ample resources online to assist with this configuration work.
Once you have completed your edits, save the Telegraf configuration file. You will upload this file in the next step.
Step 3: Update the Telemetry Collector with Your Custom Telegraf Configuration
- Navigate to Sensors > Collectors > Telemetry Collectors.
- Select the XE or XR Telemetry Collector that you created from the list. A side panel appears.
- Select the Configuration tab.
- Change the Telegraf Configuration value from the existing XE or XR value to Custom.
- Use the file upload box to upload your new Telegraf configuration file.
Change the Telegraf Configuration to "Custom":

Upload your custom TOML file:

After saving, the platform confirms the new configuration is applied.

Step 4: Deploy and Verify
Deploy the Telemetry Collector and a Sensor Collector to start data flow to Crosswork Assurance. For deployment instructions, see:
- Docker: Deploy Telemetry Collector in Docker
- Kubernetes: Deploy Telemetry Collector in Kubernetes
Step 5: Curate Incoming Telemetry
Use the Ingestion Staging feature to edit and curate the incoming telemetry to meet your specific needs. See Advanced Topic: Ingestion Specification Custom Metrics for details on configuring ingestion specifications.
© 2026 Cisco and/or its affiliates. All rights reserved.
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms