- 14 May 2023
- 6 Minutes to read
- Print
- DarkLight
- PDF
Adapter Connections
- Updated on 14 May 2023
- 6 Minutes to read
- Print
- DarkLight
- PDF
From the Adapters page, click Adapter Connections to open the Connections page. You can also open this page from any single adapter.
Use the adapter Connections page to see a centralized summary of information about all adapters and their connections. You can see the discovery schedule of each adapter and any adapter connections that have custom discovery schedules as well as some of the advanced settings configured. In addition, you can see the polling schedule for each adapter.
From the Connections page you can add connections, and you can also perform actions on a single connection or in bulk on a number of selected connections.
The following information is displayed:
- Adapter Name - the name of the adapter.
- Connection Label - The connection label (if configured)
- Connection ID - The connection ID.
- Instance - The specific Instance the adapter and connection were initiated from.
- Connection Status – The status of the connection: 'Active and connected', 'Active with errors', or 'Inactive'.
- Last Fetch Status - Displays the status of the last fetch as displayed on the Adapter Fetch History page:
- Connection failed
- Fetch ended successfully
- Fetch ended with errors
- Fetch failed
- Fetch skipped
- Fetch started
- Fetch terminated
- Last Successful Fetch - Shows the time and date of the last fetch that was successful for this connection.
- Discovery Schedule (UTC) – This shows the discovery schedule. While some adapters are set to the default discovery, others may have custom discovery settings that were set using the Advanced Configuration tab for the connection. If adapters are set for real time discovery, this is also displayed.
- Advanced Configuration - Shows if advanced discovery for each adapter connection is set separately, or the same configuration is used for all connections. Settings may be, 'Adapter Level', 'None' or 'Connection Level'.
- Connection Configuration - Displays the configuration of each adapter connection in JSON format.
Sensitive data, such as passwords and private keys, aren’t displayed in the JSON.
Adapter Configuration Advanced Settings
The following fields display values set in the Adapter Configuration Advanced Settings for the adapter. Refer to Adapter Advanced Settings for detailed information about each setting.
1. Ignore Not Seen Devices (hours) – Displays the number of hours set in the 'Ignore devices that have not been seen by the source in the last X hours' field in the Advanced Settings for this adapter.
2. Ignore Not Seen Users (hours) – Displays the number of hours set in the 'Ignore users that have not been seen by the source in the last X hours' field in the Advanced Settings for this adapter.
3. Hold before Fetching (hours) – Displays the number of hours set in the 'Override the global discovery schedule for this adapter to wait X hours before fetching' field in the Advanced Settings for this adapter.
4. Wait for Response (seconds) – Displays the number of hours set in the 'Wait for a response from the source for up to X seconds' in the Advanced Settings for this adapter.
5. Ignore Matching Assets – Displays whether the 'Ignore matching assets from the source if a subsequent asset was seen by the source before the previously fetched asset' in the Advanced Settings for this adapter is set or not.
6. Delete not Seen Devices (hours) – Displays the number of hours set in the 'Delete devices that have not been returned from the source in the last X hours' in the Advanced Settings for this adapter.
7. Delete not Seen Users (hours) – Displays the number of hours set in the 'Delete users that have not been returned from the source in the last X hours' in the Advanced Settings for this adapter.
8. Wait for Connection (seconds) – Displays timeout for how long to wait for the connection to the source in seconds.
9. Failed Connection Attempts before Inactive – Displays the number of failed attempts to connect before setting the adapter to inactive. This number includes all connections to the server, including periodic connection updates (if set in Data Aggregation Settings).Notes - Any notes added on the Adapter Connection Configuration page.
Changing the Order Columns are Displayed
You can change the order of columns displayed.
Drag and drop columns on the table to arrange them in the order you want. The changes are only for the current session.
Filtering the Display
You can filter the display by the following fields:
Adapter name - The name of the adapter.
Instance - The name of the instance.
Connection Status – The status of the connection: 'Active and connected', 'Active with error', or 'Inactive'.
Last Fetch Status - The status of the last fetch as displayed on the Adapter Fetch History page.
Connection Label - The connection label (if configured).
Connection ID - The connection ID.
Discovery Schedule – The discovery schedule, this is 'Default', 'Real time', any of the custom configured scheduled discoveries.
Search Connection Configuration - Search adapter connections by a key, value or combination of a key and string value of an adapter connection configuration. Note that all values are searched as string values. To search multiple values, they must be adjacent, and with the exact syntax that appears in the Connection Configuration column.
Notes - Search Notes.
You can use Select all, and Clear all in any of the filters to select or clear all of the options.
Click Reset to clear all filters.
Sorting the Display
Click on a column to sort by a specific value.
For instance, you can sort by Connection Status.
Viewing Information for a Specific Adapter
You can view information for a specific adapter.
- Click on an adapter.
- Click on the Adapter Name column. The adapter page opens on that adapter, where you can see all the configured information for that adapter, as well as review the information in the Advanced Configuration tabs.
When you click Adapter Connections, the Connections page opens, filtered to that adapter.
Editing Connection Information for a Specific Adapter
You can edit connection information for a specific adapter.
- Click on an adapter.
- Click on the Adapter Name column or any of the other columns
- The Connection dialog opens with the adapter information for all the connections for this adapter,
- Edit this information as required.
Adding a New Connection
You can add a new adapter connection either from the Adapters page or from the Connections page.
Learn more about Adding a New Adapter Connection.
Connection Actions
You can perform actions on a single connection or in bulk on a number of selected connections.
Fetching Adapter Connections
- You can run fetch on one or more adapter connections.
- Select one or more adapters. The Actions menu is active.
- Click Actions and then select Fetch.
Deleting Connections
- You can delete one or more adapter connections.
- Select one of more adapters. The Actions menu is active.
- Click Actions and then select Delete.
Exporting Adapter Connections to CSV
You can export the Adapter Connections table data to a CSV file. To export the results to a CSV file:
In the Adapter Connections page, click Export CSV on the right side of the page just above the table.
The CSV file is automatically downloaded with a name format of:
“adapters_connections< date >T< time >UTC.csv”_
Depending on your operating system settings, you may be able to edit the file name.