Skip to main content

signaloid-cli users logs

View account activity logs.

Synopsis​

signaloid-cli users logs [options]

Options​

OptionDescription
--from <iso>Filter from timestamp (ISO 8601)
--to <iso>Filter to timestamp (ISO 8601)
--limit <n>Limit number of results

Description​

The users logs command retrieves activity logs for your account, showing actions such as logins, builds created, API calls, and other account activities. Logs include timestamps, action types, resource identifiers, and IP addresses.

Examples​

View recent activity:

signaloid-cli users logs --limit 20

View activity for specific date range:

signaloid-cli users logs \
  --from 2025-01-01T00:00:00Z \
  --to 2025-01-31T23:59:59Z

Output:

{
  "logs": [
    {
      "timestamp": "2025-01-13T12:00:00Z",
      "action": "build.created",
      "resource": "bld_abc123",
      "ipAddress": "203.0.113.42"
    },
    {
      "timestamp": "2025-01-13T11:30:00Z",
      "action": "auth.login",
      "method": "apikey",
      "ipAddress": "203.0.113.42"
    }
  ]
}

Filter specific actions:

signaloid-cli users logs --limit 100 | \
  jq -r '.logs[] | select(.action == "auth.login") | "\(.timestamp)\t\(.ipAddress)"'

Monitor login activity:

#!/bin/bash
# Check for suspicious login activity

signaloid-cli users logs --limit 50 | \
  jq -r '.logs[] | select(.action == "auth.login") | "\(.timestamp)\t\(.ipAddress)"' | \
  sort -u | \
while read TIMESTAMP IP; do
  echo "Login from $IP at $TIMESTAMP"
done

Daily activity summary:

#!/bin/bash
# Daily activity summary

echo "Activity for $(date -d 'yesterday' +%Y-%m-%d):"

FROM=$(date -d 'yesterday' -u +"%Y-%m-%dT00:00:00Z")
TO=$(date -d 'yesterday' -u +"%Y-%m-%dT23:59:59Z")

signaloid-cli users logs --from $FROM --to $TO | \
  jq -r '.logs[] | .action' | \
  sort | uniq -c | sort -rn

Notes​

  • Timestamps must be in ISO 8601 format (e.g., 2025-01-13T12:00:00Z).
  • Log retention period depends on your account plan.
  • Results are returned in reverse chronological order (most recent first).
  • Use --limit to control the number of results returned.

Troubleshooting​

Empty Logs​

Problem: No activity logs returned.

Solutions:

  1. Expand date range using --from and --to options
  2. Remove or increase the --limit parameter
  3. Check if account is newly created
  4. Verify authentication status

Invalid Date Format​

Problem: Error about invalid timestamp format.

Solutions:

  1. Use ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
  2. Ensure timestamps are in UTC (ending with Z)
  3. Example: 2025-01-13T12:00:00Z

"Not authenticated" Error​

Problem: Command fails with authentication error.

Solutions:

  1. Login first: signaloid-cli auth login
  2. Verify authentication: signaloid-cli auth whoami
  3. Check API key is valid

See Also​

Last updated on