Actions7
Overview
The node "Google IDX Live" provides various operations to interact with Google IDX workspaces and related services, primarily through browser automation and API calls. The "Check Status" operation specifically checks the live status of devices on a Tailscale network by querying the Tailscale API and filtering devices based on hostname or IP prefix and their online/offline status.
This node is useful for monitoring device connectivity in real-time within a Tailscale tailnet, enabling users to filter and group devices by status or last seen time. Practical examples include:
- Monitoring which devices are currently online or offline in a corporate VPN.
- Filtering devices by hostname prefix to check status of specific subnets or groups.
- Grouping devices by status or last seen time for reporting or alerting purposes.
Properties
| Name | Meaning |
|---|---|
| Options | Collection of optional parameters for the operation. |
| - Browser WebSocket Endpoint | A string specifying the WebSocket endpoint URL to connect to an existing browser instance (used for browser automation). Optional for this operation. |
Note: For the "Check Status" operation, the node also internally uses these input parameters (not listed in the provided JSON but visible in code):
authToken(string): API token for authenticating with the Tailscale API.status(string): Filter devices by "online" or "offline".filter(string): Filter devices by "filterByHostName" or "filterByIP".prefixValue(string): Prefix string used to filter hostnames or IP addresses.groupBy(string): How to group results; options include "none", "status", "lastSeen", or "both".
These parameters control how the device list is filtered and grouped.
Output
The output JSON structure for the "Check Status" operation contains arrays of device information objects with the following fields:
status: Array or string indicating device statuses ("online" or "offline").lastSeen: Array or string timestamps of when devices were last seen.hostnames: Array or string of device hostnames.names: Array or string of device names (hostname with prefix removed).ips: Array or string of device IP addresses.
If grouping is enabled, the output is an array of grouped objects each containing:
status: The status group key.lastSeen: Array of last seen timestamps for devices in the group.hostnames: Array of hostnames in the group.names: Array of names in the group.ips: Array of IPs in the group.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential to access the Tailscale API.
- Uses the public Tailscale API endpoint
https://api.tailscale.com/api/v2/tailnet/-/devices. - Optionally connects to a Puppeteer browser instance via a WebSocket endpoint for other operations, but not required for "Check Status".
- Requires network access to the Tailscale API.
Troubleshooting
- Missing or invalid API token: The node requires a valid Tailscale API token. If missing or incorrect, the API call will fail or return empty results.
- Network issues: Failure to reach the Tailscale API endpoint will cause errors or empty outputs.
- Filtering returns no devices: If the prefix filter or status filter is too restrictive, no devices may match. Adjust filters accordingly.
- Grouping confusion: When grouping by "both" or "lastSeen", ensure the client consuming the output can handle nested arrays.
- Browser connection errors: Although not relevant for "Check Status", other operations using Puppeteer may fail if the WebSocket endpoint is invalid or the browser disconnects.
Common error message example:
Failed to launch/connect to browser: Indicates issues connecting to the Puppeteer browser instance. Check the WebSocket endpoint and browser availability.