Torch Log Service
Torch Log Service
Torch Log Service
Document
Product News
Product Overview
Product Billing
User Guide
TLS Agent
AgentLoop
Resource management
Host group
Data collection
LogCollector collection
Introduction to LogCollector
Installation and upgrade
Collect host logs
Collect container logs
LogCollector plugins
Manage LogCollector
general reference
Data import
Cloud product log collection
TOS log collection
DBW log collection
VPN Log collection
VKE log collection
CLB log collection
CloudTrail log collection
CFW log collection
NTA log collection
ALB log collection
APMPlus log collection
veFaaS log collection
VPC log collection
veImageX log collection
TrafficRoute DNS log collection
DDoS log collection
WAF log collection
DCDN log collection
Multi-cloud security platform log collection
APIG log collection
Machine learning task log collection
CR log collection
Volcano Ark application lab log collection
FileNAS log collection
LLM Application Firewall Service log collection
vePFS log collection
Cloud security center log collection
EFS log collection
Data storage
Query and analysis
Configure log indexes
Query log
Analyze logs
Query and analyze logs using third-party tools
Associate external data source for log query
SQL function
SQL syntax
Visualization
Query and analysis charts
Summaries of query and analysis charts
Create dashboard
Use dashboard
Add dashboard filters and variables
Use other systems to analyze logs
Log application
Log applications for product observability
Log applications for large models observability
Coding Agent log app
ModelProvider log app
No-coding Agent log app
Log applications for basic service monitoring
Data processing
Data transformation
Syntax and functions
Global operation function
expression function
Data processing best practices
general reference
Data write processor
Data consumer processor
Data consumption and shipping
Ship logs to TOS
Ship logs to Kafka
Ship logs to Splunk
Alarm
Alarm policy
Alarm notification content
Alarm notification content template
alarm notification channel
Tracing service
Monitor Log Service
API reference
Project management API
Topic management API
Shard management API
Index management API
Log management API
Host group management API
Collection configuration management API
Data import API
Data processor API
Data transformation API
Data backflow API
SQL analysis API
Alarm management API
Consumer group management API
Kafka protocol consumption API
Tag management API
Trace storage API
Account management API
SDK reference
Go SDK
Java SDK
Python SDK
iOS SDK
C++ SDK
CLI reference
Best practices
Data collection
Query and analysis
permission management
Consumption and delivery
Visualization
Alarm
FAQs
Billing and cost FAQ
Data collection FAQ
Data storage FAQ
Index configuration FAQ
Query and analysis FAQ
Scheduled SQL tasks FAQ
Alarm FAQ
- Documentation
Torch Log ServiceSDK referenceGo SDKSend logs to TOS using Go SDK
Copy page
Download PDFGo SDK
Send logs to TOS using Go SDK
Copy pageDownload PDFSend logs to TOS using Go SDK
TLS supports delivering logs to TOS via SDK. This document uses example code to demonstrate how to deliver logs to TOS using the Go SDK.
Prerequisites
- The TLS Go SDK has been installed. For more information, see Install Go SDK.
- The following commands have been executed to install the proto dependencies.
- go get -u github.com/gogo/protobuf/proto
- The VOLCENGINE_ACCESS_KEY_ID and other environment variables have been added. For the method of configuring environment variables, please refer to Configure authentication information.
warning
It is recommended to dynamically obtain Volcengine keys and other authentication information through environment variables to avoid the data security risks caused by hardcoding AccessKey.
Scenario description
This document demonstrates, through example code, how to use the GO SDK to create a configuration for delivering logs to TOS in a specified Project. Please refer to Overview for related notes and fee information.
Sample code
package demo
import (
"github.com/volcengine/volc-sdk-golang/service/tls"
"os"
"time"
)
func CreateShipperTosDemo() (*tls.CreateShipperResponse, error) {
// When initializing the client, it's recommended to dynamically obtain the Volcano Engine key and other authentication information through environment variables to avoid data security risks caused by hard-coding the AccessKey. For detailed instructions, see https://www.volcengine.com/docs/6470/1166455.
// When using STS, both ak and sk use temporary keys and set VOLCENGINE_TOKEN; when not using STS, the VOLCENGINE_TOKEN part is passed empty.
client := tls.NewClient(os.Getenv("VOLCENGINE_ENDPOINT"), os.Getenv("VOLCENGINE_ACCESS_KEY_ID"), os.Getenv("VOLCENGINE_ACCESS_KEY_SECRET"), os.Getenv("VOLCENGINE_TOKEN"), os.Getenv("VOLCENGINE_REGION"))
//Create a data delivery configuration.
//For a description of the CreateShipper API request parameters, see https://www.volcengine.com/docs/6470/1333747.
createShipperRes, err := client.CreateShipper(&tls.CreateShipperRequest{
TopicId: "c7****",
ShipperName: "tosship",
ShipperType: "tos",
ShipperStartTime: int(time.Now().UnixMilli()),
ShipperEndTime: int(time.Now().UnixMilli()) + 3600*1000,
TosShipperInfo: &tls.TosShipperInfo{
Bucket: "mytos",
Prefix: "testprefix",
MaxSize: 10,
Compress: "none",
Interval: 900,
PartitionFormat: "%Y/%m/%d/%H",
},
ContentInfo: &tls.ContentInfo{
Format: "json",
JsonInfo: &tls.JsonInfo{
Keys: []string{"__content__", "__source__", "__path__"},
Enable: true,
Escape: true,
},
},
})
if err != nil {
return nil, err
}
return createShipperRes, nil
}
Related documentation
- After you send an API request through the SDK, you will receive a response from the server. If the response contains a status code other than 200, it indicates that the API call has failed. You can refer to the documentation for each API to view the corresponding error code information.
- The API interfaces involved in this example are as follows. You can refer to the API documentation to view detailed information about the corresponding interface.
- APIDescriptionAPIDescriptionCall the CreateShipper API to create a delivery configuration.Call the DeleteShipper API to delete the specified delivery configuration.Call the ModifyShipper API to modify the specified delivery configuration.Call the DescribeShipper API to obtain detailed information about the delivery configuration.Call the DescribeShippers API to obtain the delivery configuration list.
Last updated: 2025.10.11 16:44:08
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
