Dataiku DSSInstall

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of administrative and operational tasks within a Dataiku DSS instance. Specifically, for the DSS Administration resource and the Append Entry to Audit Trail operation, the node allows appending custom entries to the audit trail of the DSS instance. This is useful for logging custom events or messages that are not automatically captured by DSS but are important for auditing or tracking purposes.

Common scenarios include:

• Adding custom audit logs for specific business processes.
• Tracking manual interventions or external system interactions.
• Enhancing compliance and traceability by recording additional context in the audit trail.

Example use case:

• A user wants to log a custom message type with details about a manual data correction performed outside of automated workflows. Using this node, they can append an entry with a custom message type and relevant details to the DSS audit trail.

Properties

Output

The output of this operation is the response from the Dataiku DSS API after attempting to append the audit trail entry. It is returned as JSON and typically contains confirmation or details about the appended entry.

• The json output field will contain the parsed JSON response from the API.
• If the API returns no content, the node outputs a status code indicating "204 No Content".
• This operation does not produce binary data.

Dependencies

• Requires an active connection to a Dataiku DSS instance.
• Requires valid API credentials (an API key) for authentication with the DSS server.
• The node expects the DSS server URL and user API key to be configured in the credentials.
• No additional external dependencies beyond the Dataiku DSS API.

Troubleshooting

• Missing Credentials Error: If the node throws an error about missing credentials, ensure that the API key credential for Dataiku DSS is properly set up and selected.
• Required Parameter Errors: The operation requires the "Custom Message Type" property; if omitted, the node will throw an error indicating this requirement.
• API Request Failures: Network issues, incorrect server URLs, or invalid API keys may cause request failures. Verify connectivity and credentials.
• Invalid JSON in Request Body: Ensure the "Request Body" property contains valid JSON; otherwise, the API call may fail.
• Unexpected Response Format: If the API response cannot be parsed as JSON, the raw text is returned. Check the API server logs or response for clues.

Links and References

• Dataiku DSS API Documentation — Official documentation for the Dataiku DSS REST API.
• Audit Trail in Dataiku DSS — Information on audit trail usage and management in DSS.