emqx_audit_api.hocon 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. emqx_audit_api {
  2. audit_get.desc:
  3. """Get audit logs with filtering parameters. This feature enables users to efficiently
  4. access the desired audit trail data and facilitates auditing, compliance,
  5. troubleshooting, and security analysis."""
  6. audit_get.label:
  7. "List audit logs"
  8. filter_node.desc:
  9. "Filter logs by the node name where the logs were generated."
  10. filter_from.desc:
  11. """Filter logs by source type. Possible values are:
  12. - `dashboard`: Dashboard request logs.
  13. - `rest_api`: API KEY request logs.
  14. - `cli`: The emqx command line logs.
  15. - `erlang_console`: The emqx remote_console run function logs."""
  16. filter_source.desc:
  17. """Filter logs by source. Possible values are:
  18. - The login username to filter logs generated from Dashboard for this specific user.
  19. - The API Key to filter logs generated from the REST API for this specific API key.
  20. - An empty string to filter logs generated from CLI or Erlang console."""
  21. filter_source_ip.desc:
  22. "Filter logs by source IP when logs, applicable for logs generated from Dashboard or REST API operations."
  23. filter_operation_id.desc:
  24. "Filter logs by swagger's operation_id, applicable for logs generated from Dashboard or REST API operations."
  25. filter_operation_type.desc:
  26. "Filter logs by operation type."
  27. filter_operation_result.desc:
  28. "Filter logs by operation result."
  29. filter_http_status_code.desc:
  30. """Filter The HTTP API logs by response code, applicable for logs generated from Dashboard or REST API operations."""
  31. filter_http_method.desc:
  32. """Filter The HTTP API logs by method, applicable for logs generated from Dashboard or REST API operations."""
  33. filter_gte_duration_ms.desc:
  34. """Filter logs by age duration, selecting those created no earlier than then given duration time ago."""
  35. filter_lte_duration_ms.desc:
  36. """Filter logs by age duration, selecting those created no later than then given duration time ago."""
  37. filter_gte_created_at.desc:
  38. """Filter logs by creation time, selecting logs created no earlier than the given timestamp.
  39. The timestamp can be provided either in rfc3339 string format or as a millisecond epoch timestamp."""
  40. filter_lte_created_at.desc:
  41. """Filter logs by creation time, selecting logs created no later than the given timestamp.
  42. The timestamp can be provided either in rfc3339 string format or as a millisecond epoch timestamp."""
  43. }