Graylog

Overview

The Graylog node for n8n enables users to interact with the Graylog API, specifically to export message tables. This is useful for automating log data extraction, analysis, and reporting workflows. For example, you might use this node to:

• Export logs matching specific search criteria for compliance or auditing.
• Download filtered event/message tables for further processing in downstream nodes.
• Automate regular exports of log data for backup or integration with other systems.

Properties

Additional Fields (collection options)

• Search Id (string): Filter messages by a specific search identifier.
• Search Type Id (string): Further filter by search type.
• Timerange From/To (string): Define the time range for exported messages.
• Timerange Type (string): Specify the type of time range (e.g., absolute, relative).
• Filename (string): Set the filename for the exported table.
• Limit (number): Maximum number of messages to export.
• Time Zone (string): Time zone context for the export.
• Fields In Order (fixedCollection): Specify the order of fields in the exported table.

Output

• The node outputs a json object containing the exported message table from Graylog.
• If "Simplify" is enabled, the output may be a simplified version or a specific property defined by "Simplify Path".
• If binary data is involved (e.g., exporting as a file), the output will include a binary field representing the exported file.

Dependencies

• Graylog API: Requires access to a running Graylog instance.
• API Credentials:
  • Token Authentication: Needs a valid Graylog API token.
  • Basic Authentication: Requires username and password.
• n8n Credentials: Must configure either graylogTokenApi or graylogBasicApi credentials in n8n.

Troubleshooting

• Authentication Errors:
  • "Invalid credentials" or "401 Unauthorized": Check that the correct authentication method and credentials are provided.
• Missing Required Fields:
  • If required fields for the export are missing, the node may throw validation errors. Ensure all necessary parameters are set.
• API Connection Issues:
  • "ENOTFOUND" or "ECONNREFUSED": Verify network connectivity to the Graylog server.
• Output Structure Unexpected:
  • If "Simplify" or "Simplify Path" is used incorrectly, the output may not match expectations. Double-check the path and simplify settings.

Links and References

• Graylog API Documentation
• n8n Documentation: Creating Credentials
• n8n Documentation: Custom Nodes