Actions7
Overview
This node, named "Google IDX Live," provides functionality to check the live status of devices connected to a Tailscale network using an authentication token. It fetches device information from the Tailscale API and allows filtering and grouping of devices based on their online/offline status, hostname prefix, or IP address prefix.
Common scenarios where this node is useful include:
- Monitoring the connectivity status of devices in a Tailscale tailnet.
- Filtering devices by hostname or IP prefix to focus on specific subnets or groups.
- Grouping devices by status or last seen time for reporting or alerting purposes.
Practical example:
- A network administrator wants to get a list of all currently online devices with hostnames starting with "office-" and group them by their last seen timestamp to identify recently active devices.
Properties
| Name | Meaning |
|---|---|
| Auth Token | The authentication token used to access the Tailscale API. |
| Status Is Running | Select which devices to check: - Get Many: Check all devices' statuses - Online: Only online devices - Offline: Only offline devices |
| Group By | How to group matched devices in the output: - Nogroup: No grouping - By Status - By Last Seen - By Status + Last Seen |
| Filter | How to filter devices: - All Instances: No filter, show all devices - Host Name Prefix: Filter by hostname prefix - IP Prefix: Filter by IP address prefix |
| Prefix Value | The prefix string used for filtering when "Host Name Prefix" or "IP Prefix" filter is selected. |
| Options | Additional options (not used for "checkLive" operation). |
Output
The node outputs JSON data containing arrays of device information objects with the following fields:
status: Array or grouped value(s) indicating device status ("online" or "offline").lastSeen: Array or grouped value(s) of timestamps representing when each device was last seen.hostnames: Array or grouped list of device hostnames.names: Array or grouped list of device names (hostnames with prefix removed if filtered).ips: Array or grouped list of device IP addresses (first IP address per device).
If grouping is applied, the output is an array of grouped objects, each containing these fields aggregated accordingly.
No binary data output is produced for the "checkLive" operation.
Dependencies
- Requires an API authentication token for the Tailscale API.
- Makes HTTP requests to the Tailscale API endpoint:
https://api.tailscale.com/api/v2/tailnet/-/devices. - No additional external services or environment variables are required specifically for the "checkLive" operation.
Troubleshooting
- No token given: If the auth token is missing or invalid, the node logs "No token given." and returns no data. Ensure the token is provided and valid.
- API request failures: Network issues or invalid tokens may cause the fetch request to fail or return empty device lists. Verify network connectivity and token permissions.
- Filtering yields no results: If the prefix filter does not match any devices, the output will be empty. Double-check the prefix value and filter type.
- Grouping confusion: When grouping by "lastSeen" or "both", the lastSeen field is converted into sets to avoid duplicates; users should expect arrays of unique timestamps.