Modify Log Retention Policy

Each log stream in your pipeline is initially assigned a default data retention policy of 30 days. The logs for each log stream are retained for the specified number of days. However, you can define a custom retention policy for each log stream. The available options for retention periods include 7, 14, and 30 days.

Note: You can alternatively use the PATCH request to update the retention policy of an existing pipeline.

The following is an example:

curl --location \
--request POST 'https://logging.de-txl.ionos.com/pipelines' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
          "properties": {
    "name": "demo",
    "logs": [
      {
        "source": "kubernetes",
        "protocol": "http",
        "tag": "k8s",
        "destinations": [
          {
            "type": "loki",
            "retentionInDays": 7
          }
        ]
      }
    ]
  }
}'

Unlimited log retention

To set the retention period for each log stream to unlimited, use the following request:

curl --location \
--request POST 'https://logging.de-txl.ionos.com/pipelines' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
          "properties": {
    "name": "demo",
    "logs": [
      {
        "source": "kubernetes",
        "protocol": "http",
        "tag": "k8s",
        "destinations": [
          {
            "type": "loki",
            "retentionInDays": 0
          }
        ]
      }
    ]
  }
}'

Note: The retention period is set to unlimited when the retentionInDays value is set to 0.

Access to the data

In Grafana, you can only access the data for a maximum of 30 days. To access the archived data (logs with unlimited retention), contact IONOS CLOUD Support.

You must provide the following information while requesting access:

• Contract number

• Pipeline ID

• Log stream tag

• The date range for which you need access to the data

• Object Storage bucket information:

  • Name

  • Region

  • Object Storage endpoint

Note: Ensure that the Object Storage Canonical User ID you receive from IONOS CLOUD Support is assigned to the designated bucket. Additionally, confirm that write access has been granted to this specific bucket.

After receiving the required information, IONOS CLOUD transfers the archived data into the designated Object Storage bucket. Following the successful upload, the data becomes available from within the Object Storage bucket. To add the grantee to your bucket, see the instructions.

Note: Storing logs for an indefinite period will increase storage costs. Our pricing for long-term log storage aligns with our standard Pricing Model.