From 253e53d857f0427d26ad7cda906c1b2bf54d9cac Mon Sep 17 00:00:00 2001 From: Oksana Levchuk Date: Thu, 14 Nov 2024 15:56:02 +0100 Subject: [PATCH] add info how near real-time exporting works --- documentation/cdn/logs/logs-uploader.md | 30 +++++++++---------------- 1 file changed, 11 insertions(+), 19 deletions(-) diff --git a/documentation/cdn/logs/logs-uploader.md b/documentation/cdn/logs/logs-uploader.md index 96dd4878..22919b24 100644 --- a/documentation/cdn/logs/logs-uploader.md +++ b/documentation/cdn/logs/logs-uploader.md @@ -1,24 +1,24 @@ --- title: logs-uploader -displayName: Logs uploader (near-realtime) +displayName: Logs uploader (near real-time) published: true order: 20 toc: --1--Logs uploader settings: "logs-uploader-settings" - --2--Logs uploader statuses: "logs-uploader-statuses" - --2--Log format: "log-format" + --2--Log format example: "log-format-example" --2--Log fields: "log-fields" --1--Configure logs for export: "configure-logs-for-export" --2--Step 1. Include empty logs: "step-1-optional-include-empty-logs" --2--Step 2. Enable origin shielding: "step-2-optional-enable-origin-shielding" --2--Step 3. Select log fields: "step-3-select-log-fields" --2--Step 4. Configure a storage provider: "step-4-configure-a-storage-provider" + --1--How near real-time log exporting works: "how-near-real-time-log-exporting-works" pageTitle: Guide on Using the CDN Logs Uploader Feature | Gcore pageDescription: A comprehensive guide on using the CDN Logs Uploader feature for exporting logs to your storage in near-realtime. --- -# Logs uploader (near-realtime) +# Logs uploader (near real-time) -Logs Uploader is a feature that enables an automatic export of CDN resource logs to your storage in near-realtime. +Logs Uploader is a feature that enables an automatic export of CDN resource logs to your storage in near real-time. Exported logs contain information about user requests sent to cache servers and pre-cache servers (if you have the Origin shielding feature enabled). @@ -32,19 +32,7 @@ This is a paid feature. To activate Logs Uploader, [contact the Gcore support te In this section, you can find general information about log settings, statuses, and how to configure logs exporting for different storage types. -### Logs uploader statuses - -You can check the status of the Logs uploader in the Gcore Customer Portal: - -* **Pending**: A status for the time interval between the connection to storage and the first log export. - -* **OK**: Logs are exported from at least one CDN server. - -* **Failed**: An error occurred while connecting to a storage, or the service failed to export logs within 24 hours. - -* **Pause**: The Logs uploader feature is paused. - -### Log format +### Log format example ``` "$remote_addr" "-" "$remote_user" "[$time_local]" "$request" "$status" @@ -419,4 +407,8 @@ Follow these instructions to export logs to \ No newline at end of file + + +## How near real-time log exporting works + +Logs are achived and exported to your storage every five minutes. If CDN servers are not requested and you didn’t select the **Do not send empty logs** checkbox when configuring Raw Logs, an empty log file (± 20 bytes) will be sent to your storage. \ No newline at end of file