Getting started with application logs
Monium Logs is a distributed and highly available system for storing, searching, visualizing, and analyzing logs. The system forms part of the Monium platform and uses its basic components, such as access management, data model, and unified interface.
This section provides general information about transferring logs from your app to Monium and viewing them.
For Yandex Cloud resources, see Getting started with Yandex Cloud resource logs.
Log delivery
If you are new to Yandex Cloud or have no application to test sending logs from, visit Getting started with Monium. The section describes the basic environment setup and sending telemetry data with the help of Otel Collector.
In Monium, log delivery is configured similarly to other types of telemetry. Data is received in OpenTelemetry format; therefore, you can send logs either using an agent or collector that supports it or send directly from the application.
If your cloud and application are already configured and you have prior experience with telemetry, configure log delivery as detailed below.
Monium.Logs parameters
-
Monium accepts data in OpenTelemetry (OTLP)
format. -
Address for writing logs:
ingest.monium.yandex.cloud:443. -
Authentication:
- Service account with the
monium.logs.writerrole or commonmonium.telemetry.writerrole. - API key with the
yc.monium.logs.writeoryc.monium.telemetry.writescope.
- Service account with the
-
In header:
x-monium-project=<project_ID>parameter.This may be a cloud (
cloud__<cloud_ID>) project, folder (folder__<folder_ID>) project, or another project. -
In
OTEL_RESOURCE_ATTRIBUTES:clusterordeployment.nameandserviceorservice.name.If no cluster is specified, the default option is
cluster = default.
Viewing logs
-
On the Monium
home page, select Logs on the left. -
At the top, set the data search period on the timeline.
-
In the search bar, enter a query to search for application logs:
-
project = <project_ID>: Select the project specified inx-monium-projectof the application's telemetry transmission configuration.This may be a cloud (
cloud__<cloud_ID>) project, folder (folder__<folder_ID>) project, or another project. -
cluster = <cluster_name>: Select the name of the installation that runs your application. If no cluster is specified,cluster = defaultis used. -
service = <service_name>: Name of your application or service. You can use theOTEL_SERVICE_NAMEenvironment variable to provide it.If you do not see the required labels in the suggestions, you can enter them manually. However, the system most likely has not received data with these labels. See Data delivery troubleshooting for possible solutions.
-
-
Click Execute query.
-
To view logs for a specific entry, expand it.
For more on logs, see Log search and analysis.
Service dashboard for logs
The system automatically collects incoming log metrics: data volume, delivery delays, number of errors by level, etc.
Incoming log charts are available on the service dashboard.