diff --git a/en/asgardeo/docs/guides/asgardeo-logs/index.md b/en/asgardeo/docs/guides/asgardeo-logs/index.md index 34052596ad..6cc09057b5 100644 --- a/en/asgardeo/docs/guides/asgardeo-logs/index.md +++ b/en/asgardeo/docs/guides/asgardeo-logs/index.md @@ -41,4 +41,9 @@ Click the **filter icon** next to one or more of the log parameters and Asgardeo For example, if you would like to view logs related to a request, click the filter icon next to the relevant traceId and click **Run Query** to filter out all the related logs. -![Logs filter by specific value]({{base_path}}/assets/img/guides/asgardeo-logs/logs-filter-by-specific-value.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"} \ No newline at end of file +![Logs filter by specific value]({{base_path}}/assets/img/guides/asgardeo-logs/logs-filter-by-specific-value.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"} + + +## Remote Log Publishing + +Asgardeo allows you to securely publish both audit and diagnostic logs to external servers for long-term storage and analysis. You can configure separate publishers for audit and diagnostic logs with custom settings for each. Learn more about setting up [Remote Log Publishing]({{base_path}}/guides/asgardeo-logs/remote-log-publish). diff --git a/en/asgardeo/docs/guides/asgardeo-logs/remote-log-publish.md b/en/asgardeo/docs/guides/asgardeo-logs/remote-log-publish.md new file mode 100644 index 0000000000..ca0bbbe59e --- /dev/null +++ b/en/asgardeo/docs/guides/asgardeo-logs/remote-log-publish.md @@ -0,0 +1,68 @@ +# Remote Log Publishing + +Remote Log Publishing enables organizations to securely transmit and store both audit and diagnostic logs in an external server. This capability ensures that critical log data is preserved in a secure location while remaining accessible for analysis and compliance auditing. + +## Configure Remote Log Publishing + +Follow these steps to set up remote log publishing: + +1. On the Asgardeo Console, navigate to **Logs**. +2. Click on the **Configure** button in **Remote Log Publishing**. +3. You will see two sections for configuring remote publishers: + * Diagnostic Logs Publisher + * Audit Logs Publisher + +!!! warning + - Configuration updates may take up to 15 minutes to propagate to the server. + - There can be a delay of up to 5 minutes in log publishing after an event occurs. + +For each publisher, you can configure the following settings: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionExample Value
Destination URLThe URL of the remote log server where logs will be published.https://logserver.example.com/store
Log publish intervalThe time interval in minutes between log publishing attempts. Must be at least 15 minutes.15
Connection timeoutThe timeout in milliseconds for connecting to the remote server. Timeout should be between 1000 and 60000.1000
Verify the hostnameWhen enabled, verifies the remote server's hostname against its SSL certificate.False
Remote server usernameThe username for basic authentication with the remote server.username
Remote server passwordThe password for basic authentication with the remote server.password
+ +After configuring the settings: + +1. Click **Update** to save your configuration. +2. Use the **Test** button to verify the connection with your remote server using the saved configuration. This will publish logs for last 15 minutes. + +!!! tip + - Configure both publishers separately if you want to store audit and diagnostic logs in different locations. + - Ensure secure transmission by using HTTPS URLs for your destination servers. + - Test the publisher configuration after setup to verify connectivity. + - If you encounter issues, check your network connectivity and verify the remote server credentials. \ No newline at end of file diff --git a/en/asgardeo/mkdocs.yml b/en/asgardeo/mkdocs.yml index 47065627a1..5535229502 100644 --- a/en/asgardeo/mkdocs.yml +++ b/en/asgardeo/mkdocs.yml @@ -420,6 +420,7 @@ nav: - Asgardeo logs: guides/asgardeo-logs/index.md - Diagnostic logs: guides/asgardeo-logs/diagnostic-logs.md - Audit logs: guides/asgardeo-logs/audit-logs.md + - Remote log publish: guides/asgardeo-logs/remote-log-publish.md - Monitoring: - Monitoring: guides/monitoring/index.md - PII in Asgardeo logs: guides/monitoring/pii-in-asgardeo-logs.md