Graylog icon

Graylog

Consume Graylog API (v.1.1.0)

Actions20

Overview

The "Graylog" n8n node, specifically for the Messages resource and the Retreive Job Results operation, is designed to fetch the results of a previously initiated export job from a Graylog server. This is useful in scenarios where you have triggered an export (such as exporting logs or messages) and need to programmatically retrieve the results once the export job has completed.

Common use cases:

  • Automating the retrieval of exported log data for further processing or archiving.
  • Integrating Graylog exports into larger workflows, such as alerting, reporting, or compliance checks.
  • Fetching specific parts of the export result using path-based simplification.

Practical example:
After scheduling a message export job in Graylog, you can use this node to periodically check and download the results, optionally extracting only relevant fields for downstream automation.

Properties

Name Type Meaning
Authentication options The authentication method to use for connecting to Graylog ("Token Authentication" or "Basic Authentication").
Export Job Id string ID of an existing export job whose results you want to retrieve.
Simplify boolean If enabled, simplifies the output by returning only the value at the specified path.
Simplify Path string (Optional) Path to the property that should be returned if "Simplify" is enabled.

Output

  • The node outputs a json field containing the results of the export job.
  • If Simplify is enabled and a Simplify Path is provided, only the value at that path within the export result will be returned.
  • Otherwise, the full export job result object is returned.
  • Binary Data: There is no indication from the static analysis that binary data is directly output by this operation; the output is structured JSON.

Dependencies

  • External Services: Requires access to a Graylog server with API enabled.
  • Authentication: Needs either a valid Graylog API token or username/password credentials, depending on the selected authentication method.
  • n8n Credentials: You must configure either the "graylogTokenApi" or "graylogBasicApi" credential in n8n, matching your chosen authentication method.

Troubleshooting

Common Issues:

  • Invalid Export Job Id: If the provided Export Job Id does not exist or is incorrect, the node may return an error indicating the job was not found.
  • Authentication Errors: Incorrect or missing credentials will result in authentication failures. Ensure the correct credential type is selected and configured in n8n.
  • Permission Denied: The Graylog user associated with the credentials must have permission to access export jobs and their results.
  • Empty Results: If the export job has not completed or contains no data, the output may be empty or incomplete.

Error Messages & Resolutions:

  • "401 Unauthorized": Check your credentials and ensure they are active and have sufficient permissions.
  • "404 Not Found": Verify the Export Job Id is correct and the job exists on the Graylog server.
  • "Missing required parameter": Ensure all required properties, especially Export Job Id, are filled in.

Links and References

Discussion