You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by "ShyunnY (via GitHub)" <gi...@apache.org> on 2024/10/20 08:32:18 UTC
[PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
ShyunnY opened a new pull request, #748:
URL: https://github.com/apache/skywalking-website/pull/748
(no comment)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "wu-sheng (via GitHub)" <gi...@apache.org>.
wu-sheng merged PR #748:
URL: https://github.com/apache/skywalking-website/pull/748
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "wu-sheng (via GitHub)" <gi...@apache.org>.
wu-sheng commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1807783801
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
Review Comment:
Please put a translation version into EN part. Thanks.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "mrproliu (via GitHub)" <gi...@apache.org>.
mrproliu commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1808871391
##########
content/blog/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,159 @@
+---
+title: "Use of SkyWalking Go Toolkit Log and Metrics"
+date: 2024-10-20
+author: "ShyunnY"
+description: "This document presents an introduction to and usage of the toolkit Log and Metrics in SkyWalking Go."
+
+---
+
+## Intro
+
+Apache SkyWalking Go is an observability tool specifically designed for Golang applications, aimed at monolithic services, microservices, cloud-native architectures, and containerized applications. It is the Go language implementation of the Apache SkyWalking probe project, providing comprehensive capabilities for service tracing, performance metrics analysis, and application topology analysis.
+
+SkyWalking Go leverages Go's concurrency features to achieve efficient data collection and analysis. By inserting a minimal amount of probe code into the application during compilation using AST (Abstract Syntax Tree), it can capture service request and response data, as well as system runtime status information. By reporting this collected data, SkyWalking Go can generate detailed service call chain diagrams, helping developers understand the dependencies between services and the performance status of each service.
+
+SkyWalking Go currently provides the following three capabilities for users to manually report relevant information:
+* Trace
+* Metrics
+* Log
+
+This document aims to guide users on how to manually report log entries and metrics using the toolkit. For information on how to report trace linkage information with the toolkit, please refer to the [SkyWalking Go Toolkit Trace Detailed Explanation](https://skywalking.apache.org/blog/2023-10-18-skywalking-toolkit-trace/).
+
+Before diving deeper, you may want to check the [SkyWalking Go Agent Quick Start Guide](https://skywalking.apache.org/blog/2023-06-01-quick-start-with-skywalking-go-agent/) to learn how to use the SkyWalking Go Agent.
+
+The following sections will introduce how to use these interfaces in specific scenarios.
+
+## Import Trace Toolkit
+
+First, execute the following command in the root directory of the project:
+
+```shell
+go get github.com/apache/skywalking-go/toolkit
+```
+
+## Manually report logs
+
+In traceability, logs play a crucial role. They record detailed information about each request in the system, including timestamps, processing nodes, error messages, etc., which helps developers and operations teams quickly identify performance bottlenecks and the root causes of failures. By comparing logs from different requests, teams can analyze the flow of requests, optimize system architecture, and improve service response speed and stability.
+
+In the SkyWalking Go toolkit, manually reported logs will be **attached to the current context Span**, allowing us to associate specific log information with particular spans.
+
+First, we need to import the toolkit log package:
+
+```go
+"github.com/apache/skywalking-go/toolkit/logging"
+```
+
+We can build a simple web service that determines the validity of a username based on the request parameters. When the userName parameter is invalid, we log an error using the logging.Error API. This log will be attached to the currently active Span in the context.
+
+When recording logs, we can also append keyValues to the log information using variadic parameters, making the log entries more descriptive.
+
+For detailed usage documentation, please refer to [SkyWalking Go toolkit-logging](https://skywalking.apache.org/docs/skywalking-go/next/en/advanced-features/manual-apis/toolkit-log/).
+
+
+```go
+package main
+
+import (
+ "log"
+ "net/http"
+
+ _ "github.com/apache/skywalking-go"
+ "github.com/apache/skywalking-go/toolkit/logging"
+)
+
+func main() {
+ http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
+ userName := r.URL.Query().Get("userName")
+ if len(userName) == 0 || userName != "root" {
+ // Log an entry, which will be attached to the currently active Span in the context.
+ // We can append log tags using variadic parameters.
+ logging.Error("deny user login", "userName", userName)
Review Comment:
Does the screenshot in the EN version still have Chinese? Could you help to replace it as english version?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "mrproliu (via GitHub)" <gi...@apache.org>.
mrproliu commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1807795436
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
+title: "SkyWalking Go Toolkit Log 与 Metrics 的使用"
+date: 2024-10-20
+author: "ShyunnY"
+description: "本文展示了 Skywalking Go 中 toolkit Log 和 Metrics 的介绍和用法"
+
+---
+
+## 引言
+
+Apache SkyWalking Go是一款针对 Golang 应用程序提供可观测的工具, 旨在为单体服务、微服务、云原生架构和容器化应用设计。
+它是 Apache SkyWalking 项目的 Go 语言实现，提供了全面的服务追踪、性能指标分析、应用拓扑分析等功能。
Review Comment:
```suggestion
它是 Apache SkyWalking 探针项目的 Go 语言实现，提供了全面的服务追踪、性能指标分析、应用拓扑分析等功能。
```
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
+title: "SkyWalking Go Toolkit Log 与 Metrics 的使用"
+date: 2024-10-20
+author: "ShyunnY"
+description: "本文展示了 Skywalking Go 中 toolkit Log 和 Metrics 的介绍和用法"
+
+---
+
+## 引言
+
+Apache SkyWalking Go是一款针对 Golang 应用程序提供可观测的工具, 旨在为单体服务、微服务、云原生架构和容器化应用设计。
+它是 Apache SkyWalking 项目的 Go 语言实现，提供了全面的服务追踪、性能指标分析、应用拓扑分析等功能。
+
+SkyWalking Go利用Go语言的并发特性，实现了高效的数据采集和分析。它通过编译期间使用AST在代码中插入少量的探针代码，可以捕获到服务的请求和响应数据，以及系统的运行状态信息。
+SkyWalking Go通过上报这些收集的数据，能够生成详细的服务调用链路图，帮助开发人员了解服务之间的依赖关系，以及每个服务的性能状况。
+
+SkyWalking Go 当前提供了以下三种能力让用户手动上报相关信息
+* Trace
+* Metrics
+* Log
+
+本文旨在指导用户如何使用 toolkit 手动上报 Log日志 以及 Metrics指标。有关如何操作 toolkit Trace 上报链路信息可看 [SkyWalking Go Toolkit Trace 详解](https://skywalking.apache.org/zh/2023-10-18-skywalking-toolkit-trace/)。
+在深入了解之前，您可以参考 [SkyWalking Go Agent快速开始指南](https://skywalking.apache.org/zh/2023-06-01-quick-start-with-skywalking-go-agent/) 来学习如何使用SkyWalking Go Agent。
+
+下面将会介绍如何在特定场景中使用这些接口。
+
+## 导入 Trace Toolkit
+
+首先在项目的根目录中执行以下命令：
+
+```shell
+go get github.com/apache/skywalking-go/toolkit
+```
+
+## 手动上报 Log 日志
+
+在链路追踪中，日志扮演着至关重要的角色。它们记录系统中每个请求的详细信息，包括时间戳、处理节点、错误信息等，从而帮助开发人员和运维团队快速定位性能瓶颈和故障根源。
+通过对比不同请求的日志，团队可以分析请求的流转过程，优化系统架构，提升服务响应速度和稳定性。
+
+在 SkyWalking Go toolkit 中，手动上报的日志将会**附加在当前上下文中的 Span 上**，这使得我们可以针对特定的 Span 关联特定的日志信息。
+
+首先我们需要导入 toolkit log 包:
+
+```go
+"github.com/apache/skywalking-go/toolkit/logging"
+```
+
+我们可以构建一个简单的 Web 服务: 根据请求参数中的用户名来判断是否合法。
+当 userName 参数是非法时，我们通过 `logging.Error` API 记录一条错误日志。该日志将会附加到**当前上下文活跃的 Span 上**。
+
+在记录日志时，我们还可以通过可变参数追加 `keyValues` 到日志信息上, 让日志信息更具有描述力。
+
+详细的使用文档可看 [SkyWalking Go toolkit-logging](https://skywalking.apache.org/docs/skywalking-go/next/en/advanced-features/manual-apis/toolkit-log/)。
+
+```go
+package main
+
+import (
+ "log"
+ "net/http"
+
+ _ "github.com/apache/skywalking-go"
+ "github.com/apache/skywalking-go/toolkit/logging"
+)
+
+func main() {
+ http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
+ userName := r.URL.Query().Get("userName")
+ if len(userName) == 0 || userName != "root" {
+ // 记录一条日志信息, 这条日志信息将会附加到当前上下文活跃的 Span 上
+ // 我们可以通过可变参数追加日志Tag
+ logging.Error("拒绝非法用户登陆", "userName", userName)
+ w.WriteHeader(http.StatusUnauthorized)
+ }
+
+ w.WriteHeader(http.StatusAccepted)
+ })
+
+ if err := http.ListenAndServe(":8080", nil); err != nil {
+ log.Fatalln("server running by err:", err)
+ }
+}
+
+```
+
+## 手动上报 Metrics 指标信息
+
+Metrics在链路追踪中极为重要，它们提供了系统性能的定量分析。
+通过监控请求的延迟、吞吐量和错误率等指标，团队能够识别性能瓶颈和潜在问题，从而优化系统架构和资源分配。
+结合链路追踪，metrics能够揭示请求在各个服务间的流转情况，帮助团队深入了解系统的健康状态和使用模式，确保服务的高可用性和用户体验，最终实现业务目标的有效支持。
+
+首先我们需要导入 toolkit metric 包:
+
+```go
+"github.com/apache/skywalking-go/toolkit/metric"
Review Comment:
We should add a new section to describe what kind of metrics we are support.
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
+title: "SkyWalking Go Toolkit Log 与 Metrics 的使用"
+date: 2024-10-20
+author: "ShyunnY"
+description: "本文展示了 Skywalking Go 中 toolkit Log 和 Metrics 的介绍和用法"
+
+---
+
+## 引言
+
+Apache SkyWalking Go是一款针对 Golang 应用程序提供可观测的工具, 旨在为单体服务、微服务、云原生架构和容器化应用设计。
+它是 Apache SkyWalking 项目的 Go 语言实现，提供了全面的服务追踪、性能指标分析、应用拓扑分析等功能。
+
+SkyWalking Go利用Go语言的并发特性，实现了高效的数据采集和分析。它通过编译期间使用AST在代码中插入少量的探针代码，可以捕获到服务的请求和响应数据，以及系统的运行状态信息。
+SkyWalking Go通过上报这些收集的数据，能够生成详细的服务调用链路图，帮助开发人员了解服务之间的依赖关系，以及每个服务的性能状况。
+
+SkyWalking Go 当前提供了以下三种能力让用户手动上报相关信息
+* Trace
+* Metrics
+* Log
+
+本文旨在指导用户如何使用 toolkit 手动上报 Log日志 以及 Metrics指标。有关如何操作 toolkit Trace 上报链路信息可看 [SkyWalking Go Toolkit Trace 详解](https://skywalking.apache.org/zh/2023-10-18-skywalking-toolkit-trace/)。
+在深入了解之前，您可以参考 [SkyWalking Go Agent快速开始指南](https://skywalking.apache.org/zh/2023-06-01-quick-start-with-skywalking-go-agent/) 来学习如何使用SkyWalking Go Agent。
+
+下面将会介绍如何在特定场景中使用这些接口。
+
+## 导入 Trace Toolkit
+
+首先在项目的根目录中执行以下命令：
+
+```shell
+go get github.com/apache/skywalking-go/toolkit
+```
+
+## 手动上报 Log 日志
+
+在链路追踪中，日志扮演着至关重要的角色。它们记录系统中每个请求的详细信息，包括时间戳、处理节点、错误信息等，从而帮助开发人员和运维团队快速定位性能瓶颈和故障根源。
+通过对比不同请求的日志，团队可以分析请求的流转过程，优化系统架构，提升服务响应速度和稳定性。
+
+在 SkyWalking Go toolkit 中，手动上报的日志将会**附加在当前上下文中的 Span 上**，这使得我们可以针对特定的 Span 关联特定的日志信息。
+
+首先我们需要导入 toolkit log 包:
+
+```go
+"github.com/apache/skywalking-go/toolkit/logging"
+```
+
+我们可以构建一个简单的 Web 服务: 根据请求参数中的用户名来判断是否合法。
+当 userName 参数是非法时，我们通过 `logging.Error` API 记录一条错误日志。该日志将会附加到**当前上下文活跃的 Span 上**。
+
+在记录日志时，我们还可以通过可变参数追加 `keyValues` 到日志信息上, 让日志信息更具有描述力。
+
+详细的使用文档可看 [SkyWalking Go toolkit-logging](https://skywalking.apache.org/docs/skywalking-go/next/en/advanced-features/manual-apis/toolkit-log/)。
+
+```go
+package main
+
+import (
+ "log"
+ "net/http"
+
+ _ "github.com/apache/skywalking-go"
+ "github.com/apache/skywalking-go/toolkit/logging"
+)
+
+func main() {
+ http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
+ userName := r.URL.Query().Get("userName")
+ if len(userName) == 0 || userName != "root" {
+ // 记录一条日志信息, 这条日志信息将会附加到当前上下文活跃的 Span 上
+ // 我们可以通过可变参数追加日志Tag
+ logging.Error("拒绝非法用户登陆", "userName", userName)
Review Comment:
Can we add some screenshots about this log showing in the SkyWalking UI?
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
+title: "SkyWalking Go Toolkit Log 与 Metrics 的使用"
+date: 2024-10-20
+author: "ShyunnY"
+description: "本文展示了 Skywalking Go 中 toolkit Log 和 Metrics 的介绍和用法"
+
+---
+
+## 引言
+
+Apache SkyWalking Go是一款针对 Golang 应用程序提供可观测的工具, 旨在为单体服务、微服务、云原生架构和容器化应用设计。
+它是 Apache SkyWalking 项目的 Go 语言实现，提供了全面的服务追踪、性能指标分析、应用拓扑分析等功能。
+
+SkyWalking Go利用Go语言的并发特性，实现了高效的数据采集和分析。它通过编译期间使用AST在代码中插入少量的探针代码，可以捕获到服务的请求和响应数据，以及系统的运行状态信息。
+SkyWalking Go通过上报这些收集的数据，能够生成详细的服务调用链路图，帮助开发人员了解服务之间的依赖关系，以及每个服务的性能状况。
+
+SkyWalking Go 当前提供了以下三种能力让用户手动上报相关信息
+* Trace
+* Metrics
+* Log
+
+本文旨在指导用户如何使用 toolkit 手动上报 Log日志 以及 Metrics指标。有关如何操作 toolkit Trace 上报链路信息可看 [SkyWalking Go Toolkit Trace 详解](https://skywalking.apache.org/zh/2023-10-18-skywalking-toolkit-trace/)。
+在深入了解之前，您可以参考 [SkyWalking Go Agent快速开始指南](https://skywalking.apache.org/zh/2023-06-01-quick-start-with-skywalking-go-agent/) 来学习如何使用SkyWalking Go Agent。
+
+下面将会介绍如何在特定场景中使用这些接口。
+
+## 导入 Trace Toolkit
+
+首先在项目的根目录中执行以下命令：
+
+```shell
+go get github.com/apache/skywalking-go/toolkit
+```
+
+## 手动上报 Log 日志
+
+在链路追踪中，日志扮演着至关重要的角色。它们记录系统中每个请求的详细信息，包括时间戳、处理节点、错误信息等，从而帮助开发人员和运维团队快速定位性能瓶颈和故障根源。
+通过对比不同请求的日志，团队可以分析请求的流转过程，优化系统架构，提升服务响应速度和稳定性。
+
+在 SkyWalking Go toolkit 中，手动上报的日志将会**附加在当前上下文中的 Span 上**，这使得我们可以针对特定的 Span 关联特定的日志信息。
+
+首先我们需要导入 toolkit log 包:
+
+```go
+"github.com/apache/skywalking-go/toolkit/logging"
+```
+
+我们可以构建一个简单的 Web 服务: 根据请求参数中的用户名来判断是否合法。
+当 userName 参数是非法时，我们通过 `logging.Error` API 记录一条错误日志。该日志将会附加到**当前上下文活跃的 Span 上**。
+
+在记录日志时，我们还可以通过可变参数追加 `keyValues` 到日志信息上, 让日志信息更具有描述力。
+
+详细的使用文档可看 [SkyWalking Go toolkit-logging](https://skywalking.apache.org/docs/skywalking-go/next/en/advanced-features/manual-apis/toolkit-log/)。
+
+```go
+package main
+
+import (
+ "log"
+ "net/http"
+
+ _ "github.com/apache/skywalking-go"
+ "github.com/apache/skywalking-go/toolkit/logging"
+)
+
+func main() {
+ http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
+ userName := r.URL.Query().Get("userName")
+ if len(userName) == 0 || userName != "root" {
+ // 记录一条日志信息, 这条日志信息将会附加到当前上下文活跃的 Span 上
+ // 我们可以通过可变参数追加日志Tag
+ logging.Error("拒绝非法用户登陆", "userName", userName)
+ w.WriteHeader(http.StatusUnauthorized)
+ }
+
+ w.WriteHeader(http.StatusAccepted)
+ })
+
+ if err := http.ListenAndServe(":8080", nil); err != nil {
+ log.Fatalln("server running by err:", err)
+ }
+}
+
+```
+
+## 手动上报 Metrics 指标信息
+
+Metrics在链路追踪中极为重要，它们提供了系统性能的定量分析。
+通过监控请求的延迟、吞吐量和错误率等指标，团队能够识别性能瓶颈和潜在问题，从而优化系统架构和资源分配。
+结合链路追踪，metrics能够揭示请求在各个服务间的流转情况，帮助团队深入了解系统的健康状态和使用模式，确保服务的高可用性和用户体验，最终实现业务目标的有效支持。
+
+首先我们需要导入 toolkit metric 包:
+
+```go
+"github.com/apache/skywalking-go/toolkit/metric"
+```
+
+我们可以构建一个简单的 Echo 服务, 创建一个 `Counter` 类型的指标来记录请求次数。
+同时使用 `metric.WithLabels` 为指标添加额外的标签。
+
+```go
+package main
+
+import (
+ "log"
+ "net/http"
+
+ _ "github.com/apache/skywalking-go"
+ "github.com/apache/skywalking-go/toolkit/metric"
+)
+
+func main() {
+ // 构建一个 Counter 类型 metric
+ // 同时我们为该 Counter 设置 labels
+ counter := metric.NewCounter(
+ "http_request_count",
+ metric.WithLabels("path", "/ping"),
+ )
+
+ http.HandleFunc("/ping", func(w http.ResponseWriter, r *http.Request) {
+ // 每次请求来都计数加一
+ counter.Inc(1)
Review Comment:
Same here, we should add some screenshots about this, and add a link to helping user add widget to display them in the SkyWalking UI.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "ShyunnY (via GitHub)" <gi...@apache.org>.
ShyunnY commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1808510771
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
Review Comment:
done!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "netlify[bot] (via GitHub)" <gi...@apache.org>.
netlify[bot] commented on PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#issuecomment-2424734577
### <span aria-hidden="true">👷</span> Deploy Preview for *skywalking-website-preview* processing.
| Name | Link |
|:-:|------------------------|
|<span aria-hidden="true">🔨</span> Latest commit | 71a61c0a811dfd81fea44adbbe8287ad0525f63e |
|<span aria-hidden="true">🔍</span> Latest deploy log | https://app.netlify.com/sites/skywalking-website-preview/deploys/6714c01296192800085d6855 |
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "ShyunnY (via GitHub)" <gi...@apache.org>.
ShyunnY commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1807776871
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
Review Comment:
I have only published a blog in the `zh` directory, you can check it out https://deploy-preview-748--skywalking-website-preview.netlify.app/zh/
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "wu-sheng (via GitHub)" <gi...@apache.org>.
wu-sheng commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1807744262
##########
content/zh/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,140 @@
+---
Review Comment:
I can't see your blog at the blog page, https://deploy-preview-748--skywalking-website-preview.netlify.app/blog/
Could you recheck the format?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] doc: add sw-go tookit logging and metrics blog [skywalking-website]
Posted by "mrproliu (via GitHub)" <gi...@apache.org>.
mrproliu commented on code in PR #748:
URL: https://github.com/apache/skywalking-website/pull/748#discussion_r1808621818
##########
content/blog/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,159 @@
+---
+title: "Use of SkyWalking Go Toolkit Log and Metrics"
+date: 2024-10-20
+author: "ShyunnY"
+description: "This document presents an introduction to and usage of the toolkit Log and Metrics in SkyWalking Go."
+
+---
+
+## Intro
+
+Apache SkyWalking Go is an observability tool specifically designed for Golang applications, aimed at monolithic services, microservices, cloud-native architectures, and containerized applications. It is the Go language implementation of the Apache SkyWalking probe project, providing comprehensive capabilities for service tracing, performance metrics analysis, and application topology analysis.
+
+SkyWalking Go leverages Go's concurrency features to achieve efficient data collection and analysis. By inserting a minimal amount of probe code into the application during compilation using AST (Abstract Syntax Tree), it can capture service request and response data, as well as system runtime status information. By reporting this collected data, SkyWalking Go can generate detailed service call chain diagrams, helping developers understand the dependencies between services and the performance status of each service.
+
+SkyWalking Go currently provides the following three capabilities for users to manually report relevant information:
+* Trace
+* Metrics
+* Log
+
+This document aims to guide users on how to manually report log entries and metrics using the toolkit. For information on how to report trace linkage information with the toolkit, please refer to the [SkyWalking Go Toolkit Trace Detailed Explanation](https://skywalking.apache.org/zh/2023-10-18-skywalking-toolkit-trace/).
Review Comment:
Please update the link address as English version.
##########
content/blog/2024-10-20-skywalking-go-toolkit-metrics-log/index.md:
##########
@@ -0,0 +1,159 @@
+---
+title: "Use of SkyWalking Go Toolkit Log and Metrics"
+date: 2024-10-20
+author: "ShyunnY"
+description: "This document presents an introduction to and usage of the toolkit Log and Metrics in SkyWalking Go."
+
+---
+
+## Intro
+
+Apache SkyWalking Go is an observability tool specifically designed for Golang applications, aimed at monolithic services, microservices, cloud-native architectures, and containerized applications. It is the Go language implementation of the Apache SkyWalking probe project, providing comprehensive capabilities for service tracing, performance metrics analysis, and application topology analysis.
+
+SkyWalking Go leverages Go's concurrency features to achieve efficient data collection and analysis. By inserting a minimal amount of probe code into the application during compilation using AST (Abstract Syntax Tree), it can capture service request and response data, as well as system runtime status information. By reporting this collected data, SkyWalking Go can generate detailed service call chain diagrams, helping developers understand the dependencies between services and the performance status of each service.
+
+SkyWalking Go currently provides the following three capabilities for users to manually report relevant information:
+* Trace
+* Metrics
+* Log
+
+This document aims to guide users on how to manually report log entries and metrics using the toolkit. For information on how to report trace linkage information with the toolkit, please refer to the [SkyWalking Go Toolkit Trace Detailed Explanation](https://skywalking.apache.org/zh/2023-10-18-skywalking-toolkit-trace/).
+
+Before diving deeper, you may want to check the [SkyWalking Go Agent Quick Start Guide](https://skywalking.apache.org/zh/2023-06-01-quick-start-with-skywalking-go-agent/) to learn how to use the SkyWalking Go Agent.
Review Comment:
Same here, please update the link address
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@skywalking.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org