Activate Central Logging for a Contract

Central Logging is a prerequisite for letting integrated IONOS CLOUD products forward logs to Logging Service on your behalf. Activating it on your contract gives you region-level control over log ingestion. Activate Central Logging from the DCD or the Logging API. To find out which products integrate with Central Logging, contact your account manager or IONOS CLOUD Support.

Central Logging affects your experience and billing, so activate it on your contract before any product can ingest logs on your behalf. Activation is regional. Activate Central Logging by sending a PUT request to the regional Logging API endpoint, or let an integrated product activate it for you.

Request

Replace <region> with one of the following region codes: de-txl (Berlin), de-fra (Frankfurt), gb-lhr (London), gb-bhx (Worcester), fr-par (Paris), es-vit (Logroño), us-mci (Lenexa), us-las (Las Vegas), us-ewr (Newark).

Activate

curl --request PUT \
  --url 'https://logging.<region>.ionos.com/central' \
  --header 'Authorization: Bearer $IONOS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "properties": {
      "enabled": true
    }
  }'

Deactivate

curl --request PUT \
  --url 'https://logging.<region>.ionos.com/central' \
  --header 'Authorization: Bearer $IONOS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "properties": {
      "enabled": false
    }
  }'

Response

{
  "id": "23e6183d-6ab3-54de-b165-9b44c3589f4f",
  "type": "centrallogging",
  "href": "/central/23e6183d-6ab3-54de-b165-9b44c3589f4f",
  "metadata": {
    "createdDate": "2026-02-10T13:37:50+01:00",
    "createdBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "lastModifiedDate": "2026-02-11T13:37:50+01:00",
    "lastModifiedBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
    "resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
    "grafanaEndpoint": "https://grafana.logging.de-txl.ionos.com",
    "products": [
      "postgresql"
    ]
  },
  "properties": {
    "enabled": true
  }
}

The response returns a resource that includes the grafanaEndpoint URL for the region and enabled: true. Use the grafanaEndpoint URL to view logs forwarded by integrated products. Activate Central Logging in every region where your products run.

For the full schema, see the Logging API v1 documentation.

Note: Central Logging can also be activated through the DCD. For more information, see Central Logging.