Cloud Configuration of Tetra Agents
NOTE
To restrict access to the local Tetra Agent Management Console, you can edit the Agent’s installation folder’s permissions to grant least privilege access. For more information, see Restrict Access to Agent Installation.
Access the Agents Page
To use the cloud configuration feature, you must access the Agents page. To access the Agents page, complete the following steps.
- In the left navigation pane, select the hamburger menu icon.
- Choose Data Sources. Then, choose Agents. The Agents page appears.
Information Available on the Agents Page
Field | Description |
---|---|
Number of Agents | Total number of agents listed |
Online | Number of agents that are online |
Offline | Number of agents that are offline |
Search Text Box | Allows you to find the names of agents that match what is typed in the text box |
Connector Type Filter | Allows you to see all results (All), or to view only GDC (Generic Data Connector) or API |
Agent Type | Selections include All as well as the different types of agents that TetraScience supports, such as Empower or File-Log Agent |
Status Filter | Filters results so that you can see all statuses, only agents that are online, or only agents that are offline |
Enabled Filter | Allows you to see all Agents, only enabled Agents, or only deactivated Agents. By default, only enabled Agents are shown. Choosing No resets the status filter, because deactivated agents are likely offline. |
Status | Indicates whether the agent is online or offline, the type of agent, the type of configuration (cloud or local), and if the queue is enabled or disabled |
Details | Shows the details for each agent, including its the source and tags |
Create a New Agent
To select a connector for an agent, add an agent record, and install an agent, do the following:
- On the Agents page, choose the Create New Agent button.
- The Add Agent wizard appears.
- Select an existing connector. If you don’t have a connector, create one. See the Tetra Integrations (Data Sources) section of the documentation. Then, choose Next.
- Enter the following information about the agent:
- For Name, enter the agent’s name.
- For Description, enter the agent's description.
- (Optional) add [attributes](Attributes: Metadata, Tags, and Labels), such as labels, metadata, and tags.
- For Agent Type, select the agent type from the drop-down list.
- (For User Defined Agents only) For Source Type, enter the agent's source type.
- Choose Create Agent on Platform. A dialog appears that confirms that the Agent is created.
- Choose either Not Now or Continue Installing Agent, based on when you want to install the agent.
- If you chose to install the agent now, the Install Agent Locally page appears. Complete the instructions on that page to install the agent.
- Use the Agent ID and Org Slug to configure the installed agent.
- If using a Tetra Hub, select the Hub in the list to retrieve the connection URL. Then, choose Next.
- Select the service user the agent will communicate with the TDP or create a new service user. Enter the token for this user on the installed agent. Then, choose Next.
- To see if the agent is online or offline, select the Check Status.
- Choose Done.
Edit an Agent
To edit an agent record, do the following:
- On the Agents page, select the name of the agent that you want to edit. A menu appears on the right.
- Choose Edit. Then, modify the agent’s name, description, attributes, agent type, and source type as needed.
- Choose Save. The cloud configuration is sent to the on-premises agent. If the agent has the queue enabled in its interface, the configuration is pushed there.
Change an Agent's GDC or Connection Type
- On the Agents page, select the name of the agent that you want to either register with a new Generic Data Connector (GDC) or change to a new connection type. A menu appears on the right.
- Choose Change Connector. A dialog appears that prompts you to either select a new GDC, or No Connector if you want the agent to communicate to the TDP directly or through a Tetra Hub.
- Choose Save. The cloud configuration is sent to the on-premises agent. If the agent has the queue enabled in its interface, the configuration is pushed there.
Upload Data to an Agent by Using cURL
To see an example cURL command that uploads data to an agent, do the following:
- On the Agents page, select the name of the agent that you want to modify. A menu appears on the right.
- Choose Upload cURL command. A cURL command along with a list of required inputs appears that you can use to upload data to the selected agent.
- Choose Close.
Disable an Agent's Connection
NOTE
The TDP doesn't accept data from agents with disabled connections. Agents with disabled connections will still function, but the files will not be copied to the Tetra Data Lake by the TDP.
To disable an agent's connection, do the following:
- On the Agents page, select the name of the agent that you want to disable the connection for. A menu appears on the right.
- Choose Disable Connection. A message appears asking you to confirm that you want to disable the agent.
- Choose OK. In the agent's entry on the Agents page, Queue Disabled appears in the STATUS column.
Enable an Agent's Connection
To enable an agent's connection, do the following:
- On the Agents page, select the name of the agent that you want to enable the connection for. A menu appears on the right.
- Choose Enable. A message appears asking you to confirm that you want to enable the agent.
- Choose OK.
Enable the Agent's Queue
To enable an agent's queue, do the following:
- On the Agents page, select the name of the agent that you want to enable a queue for. A menu appears on the right.
- Choose Enable Queue. A message appears asking you to confirm that you want to enable the queue.
- Choose OK. In the agent's entry on the Agents page, Queue Enabled appears in the STATUS column.
Disable the Agent's Queue
To disable an agent's queue, do the following
- On the Agents page, select the name of the agent that you want to disable the queue for. A menu appears on the right.
- Choose Disable Queue. A message appears asking you to confirm that you want to disable the queue.
- Choose OK. In the agent's entry on the Agents page, Queue Disabled appears in the STATUS column.
Troubleshoot Agent Configuration Issues
- If you get a Cloud/Local Configuration is Out of Sync message, it means that the cloud configurations and the local configurations are different. You can review the differences by selecting the Review Cloud Configuration and Review Local Configuration buttons. You can then choose whether to push the configuration or reject it.
- If you need the org slug and token you'll need to either get it from your account page or generate a token for a service user.
- For the File-Log Agent, the username needs to have a dash. For example,
Administrator
fails, but.\\Administrator
works.
Updated 10 months ago