Clients
What Clients Are
What it is: A client is a lightweight agent service installed on your network. It runs data collection jobs on behalf of the Hydden platform, reaching systems that are not directly accessible from the cloud.
Why it matters: Most enterprise environments have systems behind firewalls or on isolated network segments. Clients bridge that gap. They connect outbound to the Hydden platform and execute collection tasks locally — no inbound firewall rules required.
The Clients page in Configuration > Discover lists all registered clients and shows their live status.
Client fields
| Field | Description |
|---|---|
| Name | A label you assign to identify the client |
| ID | UID based on client registration |
| Site | The network site this client belongs to |
| Modules | Collection modules enabled on this client |
| Connection Targets | Broker addresses the client connects through |
| Status | Online (green) or offline (red), refreshable on demand |
| Version | Client software version |
| Component | Client component type |
| Platform | OS and environment the client runs on |
| Uptime | Time since the client last started |
Add a Client
Purpose: Register a new client with your Hydden tenant using a join code generated during bootstrap.
Before you begin:
- Install and start the Hydden client service on the target machine. See Deploy a Client.
- Have the 8-digit join code from the client's Bootstrap page ready.
Steps
Open the Clients page. Navigate to Configuration > Discover and select the Clients tab.
Click + Add Client. The Add New Client dialog opens.
Enter the join code. Paste the 8-digit code into the Join Code field. The Client Name and Site fields populate automatically when the code is recognized.
(Optional) Select a template. Choose a client template from the Template drop-down. The template sets the site and module defaults for this client.
(Optional) Confirm the site. Review or update the Site field.
Click Register.
Result: The client appears in the list. Hydden assigns collection jobs based on the client's configured modules and schedules.
TIP
You can also complete registration directly from the client Bootstrap page using the Verify Registration button. See Register a Client for both methods.
Edit a Client
Purpose: Update a registered client's name, site, modules, or network addresses.
Steps
Open the Clients page. Navigate to Configuration > Discover and select the Clients tab.
Click the Edit icon next to the client you want to update. The Edit Client dialog opens.
Update the fields.
Field Notes Name Rename the client for easier identification Site Reassign to a different network site Connection Targets Add or remove broker addresses Modules Add or remove collection modules Advertise (internal/external) Drag chips to reorder — order sets connection priority Click Update.
Result: Changes take effect on the client's next check-in.
Monitor Client Status
The Clients list shows live status for each registered client.
| Indicator | Meaning |
|---|---|
| Green check | Client is online and reachable |
| Red X | Client is offline or unreachable |
Click the status icon next to a client to refresh its status on demand.
View Live Logs
Purpose: Stream real-time log output from a client for troubleshooting collection issues.
Steps
- On the Clients page, locate the client.
- Click the Live Logs icon (list icon) in the Actions column.
- The Node Logs panel opens and streams log output.
NOTE
Live Logs are available for online clients only. The icon is disabled for deleted clients.
Delete a Client
Purpose: Remove a client from the tenant.
Steps
- On the Clients page, locate the client.
- Click the Delete icon in the Actions column.
- Confirm the deletion.
Result: The client is removed. Enable Show Deleted in the toolbar to see deleted clients.