Actions20
- Legacy Actions
- Decorators Actions
- Exports Actions
- Messages Actions
- Metadata Actions
- Saved Actions
- Suggestions Actions
- Validation Actions
Overview
This n8n node allows you to interact with the Graylog API, specifically targeting the Saved resource with the GET operation. It is designed to retrieve saved objects (such as searches or dashboards) from a Graylog instance. The node supports both Token and Basic authentication methods, and provides options for customizing the query, pagination, sorting, and output simplification.
Common scenarios:
- Automating the retrieval of saved searches or dashboards from Graylog for reporting or monitoring.
- Integrating Graylog data into other workflows, such as sending summaries to Slack or storing results in databases.
- Filtering and sorting saved items based on custom queries or fields.
Practical example:
You could use this node to fetch all saved searches from Graylog, filter them by a specific query, and then process or notify your team about new or updated searches.
Properties
| Name | Type | Meaning |
|---|---|---|
| Authentication | options | The authentication method to use (Token Authentication or Basic Authentication). |
| Simplify | boolean | If enabled, simplifies the output structure for easier downstream processing. |
| Additional Fields | collection | Optional parameters to control pagination, sorting, and filtering of results: |
| - Page | number | The page number to retrieve. |
| - Per_page | number | Number of items per page. |
| - Sort | string | The field to sort the result on. |
| - Order | string | The sort direction (e.g., ascending or descending). |
| - Query | string | Query in Lucene syntax to filter results. |
| Simplify Path | string | Path to the property that should be returned when simplifying the output. |
Output
- The node outputs a
jsonobject containing the retrieved saved resources from Graylog. - If "Simplify" is enabled, the output will be a simplified version of the response, potentially extracting only the property specified by "Simplify Path".
- The exact structure depends on the Graylog API's response for the Saved resource, but typically includes metadata about each saved item (such as id, title, type, etc.).
- Binary Data: This node does not output binary data; all output is in JSON format.
Dependencies
- Graylog Instance: You must have access to a running Graylog server.
- API Credentials: Either a valid API token or username/password for Graylog, depending on the selected authentication method.
- n8n Configuration: Credentials for Graylog must be set up in n8n under "graylogTokenApi" or "graylogBasicApi".
Troubleshooting
Common Issues:
Authentication Errors:
- Error message: "Invalid credentials" or "401 Unauthorized".
Resolution: Check that the correct authentication method is selected and credentials are valid in n8n.
- Error message: "Invalid credentials" or "401 Unauthorized".
Connection Errors:
- Error message: "Unable to connect to Graylog server".
Resolution: Ensure the Graylog server URL is correct and accessible from the n8n instance.
- Error message: "Unable to connect to Graylog server".
Empty Results:
- Possible cause: Query filters may be too restrictive, or there are no saved items matching the criteria.
Resolution: Adjust the "Query" parameter or check that saved items exist in Graylog.
- Possible cause: Query filters may be too restrictive, or there are no saved items matching the criteria.
Unexpected Output Structure:
- Possible cause: "Simplify" or "Simplify Path" options may alter the output.
Resolution: Disable "Simplify" or adjust "Simplify Path" to get the desired output.
- Possible cause: "Simplify" or "Simplify Path" options may alter the output.