---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Create an Agent Client Collector configuration data file

# Create an Agent Client Collector configuration data file {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Create an Agent Client Collector configuration data file and associate it with check definitions so that you can view the information about your instance. You can also add or delete an attachment to the configuration data
files, which are used by check definitions during check executions.

## Before you begin

Role required: agent_client_collector_admin

## About this task

A check definition is an individual check entry in the system. For details, see [Agent Client Collector configuration data files](https://www.servicenow.com/docs/XkWU6zUtqGPeFo9IuB4rAQ "Your Agent Client Collector configuration data files contain the dynamic instance data that a check definition uses when you execute a check. When you create a check definition with a configuration data file, you can view the information about your instance. For example, you could view the Azure virtual machine details that are stored in the CMDB.").

Configuration data file attachments contain instance data, such as configuration item (CI) information, which is used when executing a check.

Domain separation is supported in the Agent Client Collector configuration data files.

## Procedure

1. Navigate to AllAgent Client CollectorConfigurationConfiguration Files.
2. Select New.
3. Add or remove an attachment.

   | Action | Description |
   | Add a file | Synchronize the record and the relevant MID Servers. 1. Select the paper clip icon ![Paper clip icon.](). The Attachments dialog box opens. 2. Select Choose file and select a file to attach. 3. Close the Attachments dialog box. {#create-acc-config-data-file__ol_dw3_nnr_3zb} |
   | Delete a file | Optionally, delete an attachment you don't want to be associated with the record. 1. Select Manage Attachments. The Attachments dialog box opens. 2. Select the check box next to the attachment that you want to remove. 3. Select Remove. {#create-acc-config-data-file__ol_ltf_zmr_3zb} |
   |-|-|

   {#create-acc-config-data-file__choicetable_v1p_3mr_3zb}  
   The attachment name must be unique for each domain and can consist only of alphanumeric characters.

   If the attachment contains invalid characters or is a duplicate of another attachment, the following situations occur:
   * The configuration file is automatically set to Active = False.
   * A message appears in the Error column indicating a problem with the attachment.

   {#create-acc-config-data-file__ul_umg_trn_vyb}

   Each record can contain only one attachment.
4. **Optional:** In the Description field, enter a description for the configuration data file.
5. Select Submit.

## Result

* The configuration data file is listed on the Agent Client Collector Configuration File page.
* The Name value is automatically set to the name of the attachment.
{#create-acc-config-data-file__ul_f2h_zln_vyb}

Checks use the configuration data file with instance data during check execution.

*[\>]: and then