Overview

This node integrates with the Matomo API to perform various operations related to the 'Custom Alert' resource, specifically the 'Get Alert' operation among others. It allows users to retrieve details of a specific alert by its ID, as well as manage alerts by adding, editing, deleting, and listing alerts. The node constructs API requests dynamically based on the selected resource and operation, sending HTTP requests to the Matomo API endpoint with appropriate query parameters and request bodies. This node is useful for automating the management and retrieval of custom alert data within Matomo analytics, enabling workflows that monitor and respond to alert conditions programmatically.

Use Case Examples

1. Retrieve details of a specific custom alert by its ID to monitor alert conditions.
2. List all custom alerts for given sites to audit alert configurations.
3. Add a new custom alert with specified parameters to automate monitoring of key metrics.

Properties

Output

JSON

• json - The JSON response from the Matomo API containing alert details or list of alerts depending on the operation

Dependencies

• An API key credential for Matomo API authentication

Troubleshooting

• Ensure the Matomo domain URL and authentication token are correctly configured in the node credentials to avoid authentication errors.
• Verify that the alert ID provided in the query parameters exists and is accessible with the given credentials to prevent 'alert not found' errors.
• Check the network connectivity and Matomo API endpoint availability if HTTP request errors occur.
• If the API response is empty or malformed, confirm that the query parameters are correctly set and the Matomo instance is functioning properly.

Links

• Matomo Reporting API Documentation - Official documentation for Matomo's Reporting API, including details on custom alerts and other modules.