---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama 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: Yokohama
* 
* Updated January 30, 2025
* 
* ![](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://servicenow-prod.fluidtopics.net/U9hdznY3y7S0GBH0RSjMYw "Configuration data files store dynamic instance data, such as virtual machine details, that check definitions use during execution. This ensures that checks are executed with up-to-date and accurate information about the instance being monitored.").

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