Cloud Log Service (CLS) is a SaaS Service with integrated observability that supports Log and Metric data collection, ETL, search and analysis, visualization, and alerting.
Common terminology for the CLS API interface is listed below:
| Term | Description |
|---|---|
| Logset is a classification of log topics and metric topics. A logset can contain multiple log topics and metric topics. The logset itself does not store any log data, only making user management convenient. A logset usually corresponds to a certain project/business in the company. It is advisable to group log topics of multiple applications/services under the same logset. | |
| Log Topic | A log topic is the basic unit for log data collection, storage, retrieval, and analysis on the CLS platform. Massive logs are managed by log topic, including collection rule configuration, retention time configuration, log retrieval analysis, and log download, consumption, and delivery. |
| Metric Topic | A metric topic is the basic unit for collecting, storing, retrieving, and analyzing metric data on the CLS platform. Collected metric data is managed by metric topic, including retention time configuration and search and analysis. |
| Machine Group | A machine group is a list of machines needing log collection. Log Service uses machine groups to manage ALL machines that need to collect logs using LogListener. |
| Topic Partition | A topic Partition is the smallest read-write unit in CLS. A single log topic can contain multiple partitions. The number of partitions determines the maximum data read-write capability of a log topic. |
| Data Processing | Data processing is the process of filtering, cleaning, masking, enriching, and distributing log data to target log topics. It can be understood as log ETL (Extract-Transform-Load). |
| Scheduled SQL Analysis | Scheduled SQL analysis is the process of periodically querying log data (support retrieval and SQL) based on a specified time window and saving query results to target log topic. |
| Log Group | A log group (LogGroup) is a collection of multiple logs. For log upload, to improve data reading and writing efficiency, multiple logs are packaged into a log group and uploaded to CLS in units of log groups. Logs in a log group have the same basic information (TIMESTAMP, FILENAME, SOURCE, HOSTNAME, and metadata). |
| Metric | A Metric is a measurement used to estimate system and application performance and operating status, such as CPU usage, memory usage, access throughput, response time and response success rate. Metrics are generated at regular intervals, producing a value at each point in time and form a sequence over time, which is generally called a time series, or time sequence for short. It is used for data collection and recording in systems and applications. |
For usage limits, please refer to Document Center > Log Service > Product Introduction > Specifications and Limits.
You can use the API Explorer tool to call APIs online.
This document uses creating a log topic, uploading logs, and retrieving logs as an example. The steps to call the API via the API Explorer Tool are as follows:
피드백