---
title: "VaultSpeed Agent"
canonical: "https://docs.vaultspeed.com/space/VPD/3012821038/VaultSpeed%20Agent"
format: markdown
---
The VaultSpeed Agent is a Java application that handles all the communication between local systems and the VaultSpeed cloud application. It is built with security in mind. Every 20 seconds (or more, based on your configuration), the agent polls the cloud application for new tasks and executes them. Communication is always a one-way flow, initiated by the agent, ensuring security.

### High-Level Architecture

The following diagram illustrates the high-level architecture of VaultSpeed, showcasing the role of the agent in communicating with metadata sources, generating ETL/DDL code, and deploying it to target systems:

![image](media://7eb73076-ce30-4abe-af3e-9ec98bcb5e29)

### Key Functions of the VaultSpeed Agent

The VaultSpeed Agent is responsible for several critical functions:

### Metadata Collection

- **Connects to sources through JDBC links** to collect metadata.
- The agent supports two versions:
  - **Standard Agent:** Supports standard databases.
  - **Extended Agent:** Supports additional, more complex source systems.
  Refer to the [JDBC URL formats](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/3013640213) or the cloud application for a list of supported source types.

### Storing Metadata

- Collected metadata is securely stored as CSV files.
- The agent sends metadata to the VaultSpeed cloud application for further processing.

### Code Generation and Deployment

- **Downloads DDL and ETL code** generated by the VaultSpeed cloud application.
- **Deploys the generated code** to the target data warehouse or ETL tool.

## Related Topics

- **[Agent Installation and Configuration](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/4076896954)****:** For detailed setup and installation instructions.
- **[Source Connection Details](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/3012722714)****:** Learn how to configure connections for data sources.
- **[Agent Update Procedure](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/3081306131)****:** Ensure your agent is updated to the latest version.
- **[Storing Connections](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/3291381934)****:** Best practices for securely storing connection details.
- **[Reset Agent Credentials](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/4215177222)****:** How to refresh agent credentials for secure communication.
- **[Custom Deployment Script Configuration](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/4240507056)****:** Guidance on defining custom scripts for deployment.
- **[Automated Key Renaming](https://vaultspeed.atlassian.net/wiki/spaces/VPD/pages/3629646034)**: Automatic handling of renamed keys on sources



> ℹ️ ## Table Harvesting Limitation
> ℹ️ 
> ℹ️ A limitation on table harvesting within VaultSpeed has been introduced to optimize overall system performance. 
> ℹ️ 
> ℹ️ The **maximum limit for table harvesting is set at 30,000 tables**. This adjustment ensures the efficient functioning of the system.