For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/de/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/de/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/de/guides/bare-metal-cloud/dedicated-servers/dedicated-servers-logs-to-customers.md.

OVHcloud Dedicated Servers Logs Forwarding

Als Markdown ansehen

Find out how to forward the logs of your OVHcloud Dedicated Server to Logs Data Platform, then query, visualise and archive them from your own data stream

Objective

This guide explains how to enable the forwarding of the logs of your OVHcloud Dedicated Server to Logs Data Platform (LDP), a platform that helps you store, archive, query and visualise your logs.

To find out more about Logs Data Platform before reading this guide, refer to the Logs Data Platform introduction guide.

In this guide, you will learn how to:

  • View the logs of your Dedicated Server in real time.
  • Create a subscription that forwards those logs to a Logs Data Platform data stream.
  • Query and visualise the forwarded logs.
  • Manage and delete your subscriptions.
Info

The logs described in this guide cover the installation of the operating system on your server, and are generated by OVHcloud during that installation. They are not the system logs produced by the operating system once it is running.

To centralise the logs produced by your own operating system, refer to the guide on sending Linux logs to Logs Data Platform instead.

Glossary

  • Logs Data Platform: a fully managed and secured log management platform by OVHcloud. For more information, consult the Logs Data Platform service page.
  • Data Stream: a logical partition of logs that you create in an LDP account and use when ingesting, viewing or querying your logs. Multiple sources can be stored in the same data stream, and it is the unit used to define a log pipeline (retention policy, archiving, live streaming, etc.), access rights and alert policies.
  • Logs forwarding: a feature integrated into an OVHcloud product to ingest the logs of its services into a Data Stream of an LDP account in the same OVHcloud account. You must enable it for each service.
  • Logs forwarding Subscription: when you enable logs forwarding for a given OVHcloud service to a given LDP Data Stream, a Subscription is created and attached to the Data Stream, which you then manage.

Requirements

  • A Logs Data Platform (LDP) account with at least one active Stream configured. This guide will walk you through all the necessary steps: Quick start for Logs Data Platform.
    • If you are not familiar with all the LDP Stream configuration possibilities, create a new one with the default options (indexing and WebSocket enabled, long-term storage disabled) for this guide.
  • An up-and-running OVHcloud Dedicated Server.
  • Both the LDP account and the Dedicated Server must belong to the same OVHcloud account.

OVHcloud Control Panel Access

  • Direct link:
  • Navigation path: Bare Metal Cloud > Dedicated servers > Select your server

Concepts and limits

What are the logs of a Dedicated Server?

The forwarded logs trace the successive steps of the operating system installation carried out by OVHcloud on your server.

Logs forwarding is available on all Dedicated Server ranges.

Log kinds

Logs are grouped into kinds, and each kind is subscribed to separately. A Dedicated Server currently exposes a single kind:

KindDisplay nameDescription
installOperating system installation logsDetails of the installation of the operating system on your server.

You can retrieve the list of kinds available on your server with the following API call:

To get the details of one kind, including the additional fields it returns, use the following API call:

Log contents

In addition to the fields common to every log ingested by Logs Data Platform, the install kind returns the following fields:

Field nameDescriptionType
levelCriticality level of the log entry, following the standard syslog severity values: 2 (critical), 4 (warning), 6 (info).Number
osOperating system installed on the server.String
serviceNameInternal name of your server, in the form nsxxxxx.ip-xx-xx-xx.eu.String
statusCurrent step of the operation: ola-group-doing, os-install-start, os-install-failed or os-install-ok.String
Info

The list of status values above is the current one and will evolve over time.

For the fields common to every log, refer to the field naming convention guide.

Instructions

The forwarding activation is free of charge, but you will be charged for the usage of the Logs Data Platform service as per the standard price plan. For LDP pricing, refer to the Logs Data Platform service page.

Enabling logs forwarding

OVHcloud Control Panel
OVHcloud API
Warning

These steps only apply to the .

In the OVHcloud Control Panel, go to the Bare Metal Cloud section, select Dedicated Servers, then select the server whose logs you want to forward.

Click the Logs tab.

The page is split into 2 panels:

  • On the left, the live-tail panel displays the logs of your server in real time.
  • On the right, the subscription panel lists your active subscriptions and lets you create new ones.

Since a Dedicated Server exposes a single log kind, no kind selector is displayed above the panels.

To forward your logs to Logs Data Platform, click Subscribe in the subscription panel (or Subscribe to another data stream if you already have an active subscription).

Select the Logs Data Platform account from the drop-down list at the top left, then select the target data stream in the table. Click Subscribe on the corresponding row.

Only the logs generated after the subscription is created are sent to your data stream.

For a detailed description of the live-tail and subscription panels, shared by all products compatible with OVHcloud Service Logs, refer to the Introduction to OVHcloud Service Logs with Logs Data Platform guide.

Using your Dedicated Server logs

Now that your logs are ingested and stored in your Logs Data Platform data stream, you can query them and build dashboards in the Graylog web interface.

  • In the OVHcloud Control Panel, retrieve the LDP username (for example logs-xxxx) and its password on your Logs Data Platform account home page. You can refer to the Quick start for Logs Data Platform.
  • Open the Graylog web UI. You can retrieve the link on your account home page or using your access point, depending on your account region (for example, the Gravelines region is https://gra1.logs.ovh.com/).
  • Log in to Graylog using your Logs Data Platform username and password.
  • Search through your logs across the data stream of your Logs Data Platform account. Refer to the Search Syntax Reference documentation for details on the search syntax.

For more details about how to use your logs with Logs Data Platform, including how to set up alerts, view the logs in real time through a WebSocket, build visualisations with OpenSearch Dashboards, integrate with the OpenSearch API and connect with Grafana, refer to the Introduction to Logs Data Platform.

Managing your subscriptions

At any time, you can retrieve the subscriptions attached to your Logs Data Platform data stream and disable the forwarding by cancelling your subscription on your stream, so that your Logs Data Platform stream no longer receives your Dedicated Server logs.

This does not delete the logs stored before the subscription was cancelled, as the data stored in a log stream is immutable unless you delete the entire stream.

To delete your subscription, use the following API call:

Go further

Introduction to OVHcloud Service Logs with Logs Data Platform

Quick start for Logs Data Platform

Archiving your logs - Cold-storage

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

Join our community of users.

War diese Seite hilfreich?