The Loome Agent

Organization administrators can deploy an agent for your organization that can be used in all Loome modules. On the agent page, you can configure agents and control their tenant assignments across your entire organization.

The organization administrator role can make changes to an agent. Other roles can only view the agent list.

What is an Agent?

The agent contains the code that allows rules and tasks to run using Loome Monitor and Integrate, deploy resources using Loome Assist and also sync source systems using the Loome Portal. The agent can be installed in individual tenants or in an organization to use in multiple tenants, and can be seen across multiple locations, so you can access data platforms on different servers and hosts.

Learn more about how the agent is used in:

The agent runs cross platform, meaning that users can leverage data from sources running on both Windows and Linux. The agent should be installed on a host that has access to your data sources, such as a server. Learn more about deploying an agent in the cloud or on-premises here.

You can start installing the agent on the Agents page, found in the left-hand side menu. Depending on your platform, installation can be all handled by a single PowerShell script. The same script used to install an agent can be used to update it, ensuring that your agent has everything it needs to work, and is using the latest version of the Loome Agent.

Adding an Agent to your Organization

When you add an agent to your organization, you have the option to select multiple tenants for the agent, and the agent will be available to use in those selected tenants. For example, if you have four tenants in your organization, the same agent can be used in all four tenants.

Learn more about adding an agent to your organization here.

Learn more about updating an agent in your organization here.

Learn more about individual agents for:

Manage an Organization Agent

On the agents page, as an organization administrator, you can add new agents or modify an agent’s configuration to maintain accurate agent settings, delete agents to keep your agent inventory clean and secure, and monitor agent health connectivity.

You can also view more information about an agent in the table.

It will list the description, connected status, if it is offline it will show when it was last seen, expiry, agent version, current IP Address, OS Type, and the tenants it is connected to. Click on the dropdown beside the number of tenants to view the names of the tenants.

This page shows organization-level agents. Classic tenant agents previously provisioned through each individual tenant (added before agent version 2026.04.07.1) will not appear here. We recommend migrating classic agents to organization-level agents for centralized management. You can still deploy agents through individual Loome module tenants but please note that any new agents added to an individual tenant will appear in your organization as an agent that services only one tenant.

Agent Information

You can see information about your agent after it is installed by clicking on Edit on the right of its row.

You can view the information section in ‘Installation’ from the tabs on the left.

This will provide the location of your agent logs, the agent service name and where the agent is installed.

Agent Logging

As the agent is connected to Loome in real time, you can view the agent logs as they happen.

Depending on your platform, you can find the logs in the agent logs folder. The path to this log folder can be found in the agent information section ‘Installation’ in Loome, under ‘Information about this install’. This is displayed after you install your agent, or you can come back to it when you click edit on an agent.

It will show you the following details:

  • Where the agent will be installed
  • The path where the log files can be found
  • The service name of the agent

You can find the agent logs in the provided path and under the service name provided in the agent information.

Editing an Agent in Loome

Maintain accurate agent settings by editing an agent’s configuration. When you edit an agent in Loome, you can modify its details, view information about the agent, or delete the agent.

Click on the tabs on the left of the page for each section:

  • Basics - You can change the expiry date (this has a default of three years from the creation date) and description (this is limited to 200 characters). You cannot change the agent name.
  • Networking - (Optional) You can add networking rules. This section allows specification of IP address based restrictions.
  • Tenants - You can add or deselect tenants that the agent can be used in. If this has no selections, the agent is not currently assigned to any tenants.
  • Installation - You can redownload the agent installer script to install or update the agent, copy the script - with or without the silent install option, or learn more information about your agent installation.

Save or cancel your changes at the bottom right of the page.

Deleting an Agent

Click on Edit on the agent you would like to delete.

Click on Delete.

Confirm that you would like to delete the agent.

Deleting an agent will permanently delete the agent from your organization. The agent will no longer be able to connect. This action cannot be undone.