Skip to main content

Logz.io Connection

The following guide shows you how to manage Logz.io connections in your Lumar account. Logz.io connections allow Lumar to import log data for log file analysis reports.

Creating a Logz.io connection​

To create a connection, provide a label and your Logz.io API token:

mutation CreateLogzioConnection($input: CreateLogzioConnectionInput!) {
  createLogzioConnection(input: $input) {
    logzioConnection {
      id
      label
      isWorking
    }
  }
}

Try in explorer

Querying connections​

Retrieve all Logz.io connections for an account:

query GetLogzioConnections {
  me {
    logzioConnections(first: 10) {
      nodes {
        id
        label
        isWorking
        createdAt
        createdByUser {
          id
          username
        }
      }
      totalCount
    }
  }
}

Try in explorer

The isWorking field indicates whether the connection is currently functional. If it is false, the API token may be invalid or expired.

Updating a connection​

Update the label or token of an existing connection:

mutation UpdateLogzioConnection($input: UpdateLogzioConnectionInput!) {
  updateLogzioConnection(input: $input) {
    logzioConnection {
      id
      label
      isWorking
    }
  }
}

Try in explorer

Deleting a connection​

Remove a Logz.io connection when it is no longer needed:

mutation DeleteLogzioConnection($input: DeleteLogzioConnectionInput!) {
  deleteLogzioConnection(input: $input) {
    logzioConnection {
      id
    }
  }
}

Try in explorer

Project queries​

After creating a connection, you can set up project-level queries using createLogzioProjectQuery to define which log data Lumar should fetch for a specific project. Project queries allow you to configure:

  • baseUrl -- the base URL to match in log entries.
  • dateRange -- the number of days of log data to import.
  • User agent regex patterns for desktop, mobile, and AI bot detection.

See CreateLogzioProjectQueryInput for the full list of configuration options.