This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch cn-site
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/cn-site by this push:
new 69c1e82b92c deploy: 343f94b02819309762662afdfbc09743595e2c5a
69c1e82b92c is described below
commit 69c1e82b92ca9983d8a516baf4cd6a611c6827de
Author: Alanxtl <[email protected]>
AuthorDate: Sun Aug 9 04:52:18 2026 +0000
deploy: 343f94b02819309762662afdfbc09743595e2c5a
---
css/app.css | 2 +-
css/chunk-vendors.css | 2 +-
en/index.xml | 25 ++--
.../golang-sdk/tutorial/observability/index.xml | 25 ++--
.../tutorial/observability/rpc_metrics/index.html | 141 ++++++++++----------
en/sitemap.xml | 2 +-
js/app.js | 3 +-
js/chunk-vendors.js | 61 +--------
sitemap.xml | 2 +-
zh-cn/index.xml | 74 +++++------
.../golang-sdk/tutorial/observability/index.xml | 74 +++++------
.../tutorial/observability/rpc_metrics/index.html | 142 +++++++++++----------
zh-cn/sitemap.xml | 2 +-
13 files changed, 247 insertions(+), 308 deletions(-)
diff --git a/css/app.css b/css/app.css
index 44c2a2c2469..b9457c8de14 100644
--- a/css/app.css
+++ b/css/app.css
@@ -1 +1 @@
-h3[data-v-76eccb7f]{margin:40px 0
0}ul[data-v-76eccb7f]{list-style-type:none;padding:0}li[data-v-76eccb7f]{display:inline-block;margin:0
10px}a[data-v-76eccb7f]{color:#42b983}.form-layout[data-v-76eccb7f]{display:flex;justify-content:space-between;align-items:flex-start}.left-form[data-v-76eccb7f]{flex:1;max-width:calc(50%
-
20px);margin-right:20px}.right-text[data-v-76eccb7f]{flex-shrink:0;width:calc(50%
- 20px)}.left-form
.el-form-item__label[data-v-76eccb7f]{text-align:left}.left-form [...]
\ No newline at end of file
+/*Respond to static link checks, which will be dynamically replaced at build
time*/
\ No newline at end of file
diff --git a/css/chunk-vendors.css b/css/chunk-vendors.css
index 61c66238ea8..b9457c8de14 100644
--- a/css/chunk-vendors.css
+++ b/css/chunk-vendors.css
@@ -1 +1 @@
-@font-face{font-family:element-icons;src:url(../fonts/element-icons.ff18efd1.woff)
format("woff"),url(../fonts/element-icons.f1a45d74.ttf)
format("truetype");font-weight:400;font-display:"auto";font-style:normal}[class*="
el-icon-"],[class^=el-icon-]{font-family:element-icons!important;speak:none;font-style:normal;font-weight:400;font-variant:normal;text-transform:none;line-height:1;vertical-align:baseline;display:inline-block;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:gr
[...]
\ No newline at end of file
+/*Respond to static link checks, which will be dynamically replaced at build
time*/
\ No newline at end of file
diff --git a/en/index.xml b/en/index.xml
index a4553a7071f..17c107c61ed 100644
--- a/en/index.xml
+++ b/en/index.xml
@@ -2732,21 +2732,20 @@ This example will demonstrate how to compile the
dubbo-pilot control plane and h
</span></span></code></pre></div><h3
id="dubbo-response-log">Dubbo response log</h3>
<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-bash" data-lang="bash"><span
style="display:flex;"><span>2020-11-17T11:31:05.718+0800 DEBUG
dubbo/dubbo.go:160 <span
style="color:#719e07">[</span>dubbo-go-pixiu<span
style="color:#719e07">]</span> dubbo client resp:map<span
style="color:#719e07">[</span>age:88 iD:3213 name [...]
</span></span></code></pre></div></description></item><item><title>Metrics
Monitoring</title><link>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</guid><description><h1
id="dubbo-go-metrics-monitoring">Dubbo-Go Metrics Monitoring</h1>
-<p>Dubbo-Go supports runtime metrics collection and integration with
<strong>Prometheus + Grafana</strong> to build observability for
microservices.</p>
-<p>This example covers two monitoring modes:</p>
-<ul>
-<li><strong>Pull Mode</strong>: Prometheus scrapes metrics
from Dubbo-Go applications. Recommended for long-running services.</li>
-<li><strong>Push Mode</strong>: Dubbo-Go applications push
metrics to Pushgateway. Recommended only for short-lived jobs.</li>
-</ul>
-<p>Example source code:</p>
+<p>Dubbo-Go can collect runtime metrics for RPC calls, metadata,
registries, config centers, and other components. This guide uses <a
href="https://github.com/apache/dubbo-go-samples/tree/main/observability/prometheus_grafana";
target="_blank">dubbo-go-samples/observability/prometheus_grafana</a>
to show both Prometheus Pull mode and Pushgateway mode.</p>
<blockquote>
-<p><a
href="https://github.com/apache/dubbo-go-samples/tree/main/metrics">https://github.com/apache/dubbo-go-samples/tree/main/metrics</a></p>
+<p>Note: some older descriptions may still mention
<code>metrics/prometheus_grafana</code>. The current sample
directory is
<code>observability/prometheus_grafana</code>.</p>
</blockquote>
-<h2 id="1-monitoring-architecture">1. Monitoring Architecture</h2>
-<h3 id="11-pull-mode-recommended-for-production">1.1 Pull Mode
(Recommended for production)</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go Application ---&gt;
Prometheus ---&gt; Grafana
-</span></span><span style="display:flex;"><span>
(exposes /metrics or /prometheus endpoint)
-</span></span></code></pre></div><p>Prometheus
actively scrapes metrics from Dubbo-Go
applications.</p></description></item><item><title>Nacos</title><link>https://cn.dubbo.apache.org/en/overview/mannual/java-sdk/reference-manual/metadata-center/nacos/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/java-sdk/reference-manual/metadata-center/nacos/</guid><description><h2
id="1-prepar [...]
+<h2 id="1-monitoring-modes">1. Monitoring Modes</h2>
+<h3 id="11-pull-mode">1.1 Pull Mode</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go application exposes /prometheus
or /metrics
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus scrapes the application
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana queries Prometheus and renders
dashboards
+</span></span></code></pre></div><p>Pull
mode is the standard Prometheus model and is recommended for long-running
Dubbo-Go providers and consumers. In this
sample:</p></description></item><item><title>Nacos</title><link>https://cn.dubbo.apache.org/en/overview/mannual/java-sdk/reference-manual/metadata-center/nacos/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/java-sdk/reference-man
[...]
<ul>
<li>Understand <a
href="https://cn.dubbo.apache.org/en/overview/mannual/java-sdk/quick-start/spring-boot/">Dubbo
basic development steps</a></li>
<li>Refer to <a
href="https://cn.dubbo.apache.org/en/overview/reference/integrations/nacos/">Nacos</a>
to start Nacos server</li>
diff --git a/en/overview/mannual/golang-sdk/tutorial/observability/index.xml
b/en/overview/mannual/golang-sdk/tutorial/observability/index.xml
index 10ab5931255..990fcee5925 100644
--- a/en/overview/mannual/golang-sdk/tutorial/observability/index.xml
+++ b/en/overview/mannual/golang-sdk/tutorial/observability/index.xml
@@ -10,21 +10,20 @@
<h2 id="1-log-configuration">1. Log Configuration</h2>
<p>As shown below, you can set the dubbo framework log behavior using
<code>log.WithZap()</code> and
<code>log.WithLevel(&quot;warn&quot;)</code>:</p></description></item><item><title>Metrics
Monitoring</title><link>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observa
[...]
-<p>Dubbo-Go supports runtime metrics collection and integration with
<strong>Prometheus + Grafana</strong> to build observability for
microservices.</p>
-<p>This example covers two monitoring modes:</p>
-<ul>
-<li><strong>Pull Mode</strong>: Prometheus scrapes metrics
from Dubbo-Go applications. Recommended for long-running services.</li>
-<li><strong>Push Mode</strong>: Dubbo-Go applications push
metrics to Pushgateway. Recommended only for short-lived jobs.</li>
-</ul>
-<p>Example source code:</p>
+<p>Dubbo-Go can collect runtime metrics for RPC calls, metadata,
registries, config centers, and other components. This guide uses <a
href="https://github.com/apache/dubbo-go-samples/tree/main/observability/prometheus_grafana";
target="_blank">dubbo-go-samples/observability/prometheus_grafana</a>
to show both Prometheus Pull mode and Pushgateway mode.</p>
<blockquote>
-<p><a
href="https://github.com/apache/dubbo-go-samples/tree/main/metrics">https://github.com/apache/dubbo-go-samples/tree/main/metrics</a></p>
+<p>Note: some older descriptions may still mention
<code>metrics/prometheus_grafana</code>. The current sample
directory is
<code>observability/prometheus_grafana</code>.</p>
</blockquote>
-<h2 id="1-monitoring-architecture">1. Monitoring Architecture</h2>
-<h3 id="11-pull-mode-recommended-for-production">1.1 Pull Mode
(Recommended for production)</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go Application ---&gt;
Prometheus ---&gt; Grafana
-</span></span><span style="display:flex;"><span>
(exposes /metrics or /prometheus endpoint)
-</span></span></code></pre></div><p>Prometheus
actively scrapes metrics from Dubbo-Go
applications.</p></description></item><item><title>Link
Tracing</title><link>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/tracing/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/tracing/</guid><description><p>Dubbo-go
suppor [...]
+<h2 id="1-monitoring-modes">1. Monitoring Modes</h2>
+<h3 id="11-pull-mode">1.1 Pull Mode</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go application exposes /prometheus
or /metrics
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus scrapes the application
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana queries Prometheus and renders
dashboards
+</span></span></code></pre></div><p>Pull
mode is the standard Prometheus model and is recommended for long-running
Dubbo-Go providers and consumers. In this
sample:</p></description></item><item><title>Link
Tracing</title><link>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/tracing/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/o
[...]
<ul>
<li><a
href="https://opentelemetry.io/docs/specs/otel/logs/sdk_exporters/stdout/">Stdout
exporter</a></li>
<li><a
href="https://opentelemetry.io/docs/languages/js/exporters/#jaeger">Jaeger
exporter</a></li>
diff --git
a/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
b/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
index fc774463ee6..f242970c113 100644
---
a/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
+++
b/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html lang=en class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=alternate hreflang=zh-cn
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><link
rel=canonical
href=https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><script>var
_paq=window._paq=window._paq||[];_paq.push(["setDocumentTitle",document.domain+"/"+document.title]),_paq.push(["setCookieDomain","*.d
[...]
+<!doctype html><html lang=en class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=alternate hreflang=zh-cn
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><link
rel=canonical
href=https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><script>var
_paq=window._paq=window._paq||[];_paq.push(["setDocumentTitle",document.domain+"/"+document.title]),_paq.push(["setCookieDomain","*.d
[...]
<a class=dropdown-item href=/en/overview/notices/>Security Notices</a>
<a class=dropdown-item href=/en/contact/>Contributor's Guide</a></div></li><li
class="nav-item nav-item-line px-2 mb-2 mb-lg-0"><a class=nav-link
href=/en/blog/><span>Blog</span></a></li><li class="nav-item nav-item-line px-2
mb-2 mb-lg-0"><a class=nav-link
href=/en/download/><span>DOWNLOAD</span></a></li><li class="nav-item dropdown
d-lg-block"><a class="nav-link dropdown-toggle" href=# id=navbarDropdown
role=button data-toggle=dropdown aria-haspopup=true
aria-expanded=false>ECOSYSTEM</ [...]
<a class=dropdown-item
href=/zh-cn/overview/mannual/control-plane/>Visualizable Console</a>
@@ -693,76 +693,89 @@
<label for=m-enoverviewnoticesprotocol-check><a
href=/en/overview/notices/protocol/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-enoverviewnoticesprotocol><span>RPC Protocol
Security</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child" id=m-enoverviewnoticesregistry-li><input
type=checkbox id=m-enoverviewnoticesregistry-check>
<label for=m-enoverviewnoticesregistry-check><a
href=/en/overview/notices/registry/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-enoverviewnoticesregistry><span>Registry Center
Security</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child" id=m-enoverviewnoticesadmin-li><input
type=checkbox id=m-enoverviewnoticesadmin-check>
<label for=m-enoverviewnoticesadmin-check><a href=/en/overview/notices/admin/
class="align-left pl-0 td-sidebar-link td-sidebar-link__page"
id=m-enoverviewnoticesadmin><span>Dubbo Admin
Security</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child" id=m-enoverviewnoticeslog4j-li><input
type=checkbox id=m-enoverviewnoticeslog4j-check>
-<label for=m-enoverviewnoticeslog4j-check><a href=/en/overview/notices/log4j/
class="align-left pl-0 td-sidebar-link td-sidebar-link__page"
id=m-enoverviewnoticeslog4j><span>Log4j Vulnerability
Impact</span></a></label></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=/en/overview/>Documentation</a></li><li class=breadcrumb-item><a [...]
-</span></span><span style=display:flex><span> (exposes /metrics or
/prometheus endpoint)
-</span></span></code></pre></div><p>Prometheus actively scrapes metrics from
Dubbo-Go applications.</p><h3 id=12-push-mode-for-short-lived-jobs>1.2 Push
Mode (For short-lived jobs)</h3><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>Dubbo-Go Application ---> Pushgateway --->
Prometheus ---> Grafana
-</span></span></code></pre></div><p>Applications push metrics to Pushgateway.
Prometheus scrapes Pushgateway.</p><p>Pushgateway is designed for
<strong>short-lived jobs (batch / cron)</strong> and is not recommended for
long-running services.</p><h2 id=2-components-overview>2. Components
Overview</h2><table><thead><tr><th>Component</th><th>Port</th><th>Description</th></tr></thead><tbody><tr><td>Grafana</td><td>3000</td><td>Metrics
visualization dashboard</td></tr><tr><td>Prometheus</td> [...]
-</span></span></code></pre></div><p>Start services:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span
style=display:flex><span>docker-compose up -d
-</span></span></code></pre></div><p>Access:</p><ul><li>Grafana: <a
href=http://localhost:3000>http://localhost:3000</a></li><li>Prometheus: <a
href=http://localhost:9090>http://localhost:9090</a></li><li>Pushgateway: <a
href=http://localhost:9091>http://localhost:9091</a></li></ul><h3
id=32-configure-environment-variables>3.2 Configure Environment
Variables</h3><p>Both client and server share the same configuration:</p><div
class=highlight><pre tabindex=0 style=color:#93a1a1;background-c [...]
-</span></span><span style=display:flex><span>
-</span></span><span style=display:flex><span><span style=color:#586e75>#
Required for Push mode</span>
+<label for=m-enoverviewnoticeslog4j-check><a href=/en/overview/notices/log4j/
class="align-left pl-0 td-sidebar-link td-sidebar-link__page"
id=m-enoverviewnoticeslog4j><span>Log4j Vulnerability
Impact</span></a></label></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=/en/overview/>Documentation</a></li><li class=breadcrumb-item><a [...]
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Prometheus scrapes the application
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Grafana queries Prometheus and
renders dashboards
+</span></span></code></pre></div><p>Pull mode is the standard Prometheus model
and is recommended for long-running Dubbo-Go providers and consumers. In this
sample:</p><table><thead><tr><th>Application</th><th>Metrics
endpoint</th></tr></thead><tbody><tr><td>go-server</td><td><code>http://localhost:9099/prometheus</code></td></tr><tr><td>go-client</td><td><code>http://localhost:9097/prometheus</code></td></tr></tbody></table><p>The
Dubbo-Go default metrics endpoint is <code>http://localh [...]
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Pushgateway stores the metrics
temporarily
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Prometheus scrapes Pushgateway
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Grafana queries Prometheus and
renders dashboards
+</span></span></code></pre></div><p>Pushgateway is better suited to
short-lived jobs such as batch or cron jobs. Prefer Pull mode for long-running
services. If you use Pushgateway, configure cleanup so stale metrics do not
remain after a job exits.</p><h2 id=2-prepare-the-sample>2. Prepare the
Sample</h2><p>Clone the samples repository and enter the sample
directory:</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-siz
[...]
+</span></span><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span></code></pre></div><p>The directory
contains:</p><table><thead><tr><th>File or
directory</th><th>Description</th></tr></thead><tbody><tr><td><code>docker-compose.yml</code></td><td>Starts
ZooKeeper, Prometheus, Pushgateway, and
Grafana</td></tr><tr><td><code>prometheus_pull.yml</code></td><td>Prometheus
configuration for Pull
mode</td></tr><tr><td><code>prometheus_push.yml</code></td><td>Prometheus
configuration for Pushgateway mode</td></tr><tr><td><code>go-server/cmd/main
[...]
+</span></span></code></pre></div><p>If your environment still uses Docker
Compose v1, run:</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span
style=display:flex><span>docker-compose up -d
+</span></span></code></pre></div><p>After startup,
visit:</p><table><thead><tr><th>Component</th><th>URL</th></tr></thead><tbody><tr><td>Grafana</td><td><code>http://localhost:3000</code></td></tr><tr><td>Prometheus</td><td><code>http://localhost:9090</code></td></tr><tr><td>Pushgateway</td><td><code>http://localhost:9091</code></td></tr><tr><td>ZooKeeper</td><td><code>127.0.0.1:2181</code></td></tr></tbody></table><h2
id=3-pull-mode-workflow>3. Pull Mode Workflow</h2><p><code>docker-com [...]
+</span></span></code></pre></div><p>For Windows PowerShell:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-powershell data-lang=powershell><span
style=display:flex><span><span style=color:#268bd2>$env:ZK_ADDRESS</span>=<span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span></code></pre></div><ol start=2><li>Start the
provider:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go --push<span style=color:#719e07>=</span><span
style=color:#b58900>false</span>
+</span></span></code></pre></div><ol start=3><li>Open another terminal, enter
the same directory, and start the consumer:</li></ol><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span><span style=display:flex><span>go run ./go-client/cmd/main.go
--push<span style=color:#719e07>=</span><span style=color:#b58900>false</span>
+</span></span></code></pre></div><ol start=4><li>Visit the metrics endpoints
exposed by the applications:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>curl
http://localhost:9099/prometheus
+</span></span><span style=display:flex><span>curl
http://localhost:9097/prometheus
+</span></span></code></pre></div><p>The output includes metrics such as
<code>dubbo_provider_</code>, <code>dubbo_consumer_</code>, and
<code>dubbo_application_</code>. For example:</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-text data-lang=text><span
style=display:flex><span>dubbo_provider_requests_total
+</span></span><span
style=display:flex><span>dubbo_consumer_requests_succeed_total
+</span></span></code></pre></div><ol start=5><li>Open
<code>http://localhost:9090/targets</code> and verify that
<code>dubbo-provider</code> and <code>dubbo-consumer</code> are
<code>UP</code>.</li></ol><h2 id=4-pushgateway-mode-workflow>4. Pushgateway
Mode Workflow</h2><p>In Pushgateway mode, Prometheus scrapes Pushgateway
instead of scraping the Dubbo-Go applications directly.</p><ol><li>Change the
Prometheus volume in <code>docker-compose.yml</code> from the Pull
configuration to the [...]
+</span></span><span style=display:flex><span> -
./prometheus_push.yml:/etc/prometheus/prometheus.yml
+</span></span></code></pre></div><ol start=2><li>Restart the monitoring
stack:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>docker
compose down
+</span></span><span style=display:flex><span>docker compose up -d
+</span></span></code></pre></div><ol start=3><li>Set environment
variables:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_URL</span><span
style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:9091"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>JOB_NAME</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"dubbo-service"</span>
</span></span><span style=display:flex><span>
-</span></span><span style=display:flex><span><span style=color:#586e75>#
Optional</span>
+</span></span><span style=display:flex><span><span style=color:#586e75># Set
these only when Pushgateway uses Basic Auth</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_USER</span><span
style=color:#719e07>=</span><span style=color:#2aa198>"username"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_PASS</span><span
style=color:#719e07>=</span><span style=color:#2aa198>"1234"</span>
-</span></span></code></pre></div><h3 id=33-start-dubbo-go-server>3.3 Start
Dubbo-Go Server</h3><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go
-</span></span></code></pre></div><h3 id=34-start-dubbo-go-client>3.4 Start
Dubbo-Go Client</h3><h4 id=default-push-mode>Default (Push Mode)</h4><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-client/cmd/main.go
-</span></span></code></pre></div><h4 id=pull-mode>Pull Mode</h4><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-client/cmd/main.go --push<span style=color:#719e07>=</span><span
style=color:#b58900>false</span>
-</span></span><span style=display:flex><span>go run ./go-server/cmd/main.go
--push<span style=color:#719e07>=</span><span style=color:#b58900>false</span>
-</span></span></code></pre></div><h3 id=35-verify-metrics>3.5 Verify
Metrics</h3><h4 id=push-mode>Push Mode</h4><p>Open:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://localhost:9091/metrics
-</span></span></code></pre></div><h4 id=pull-mode-1>Pull
Mode</h4><p><code><app_port></code> means the HTTP metrics port exposed by
the Dubbo-Go application itself, not the Prometheus or Pushgateway
port.</p><p>In this sample:</p><ul><li>Provider:
<code>http://localhost:9099/prometheus</code></li><li>Consumer:
<code>http://localhost:9097/prometheus</code></li></ul><p>These ports are
defined in <a
href=https://github.com/apache/dubbo-go-samples/blob/main/metrics/prometheus_grafana/prom
[...]
-</span></span></code></pre></div><ol start=4><li>Click <strong>Add new data
source</strong></li><li>Select
<strong>Prometheus</strong></li><li>Enter:</li></ol><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://host.docker.internal:9090
-</span></span></code></pre></div><blockquote><p>Note:
<code>host.docker.internal</code> allows Docker containers to access the host
network. Replace with your actual IP if necessary.</p></blockquote><ol
start=7><li>Click <strong>Save & Test</strong></li></ol><h3
id=42-import-dubbo-dashboard>4.2 Import Dubbo Dashboard</h3><ol><li>Navigate
to:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=lang [...]
-</span></span></code></pre></div><ol start=2><li>Import the dashboard with one
of these methods:</li></ol><ul><li>Upload <a
href=https://github.com/apache/dubbo-go-samples/blob/main/metrics/prometheus_grafana/grafana.json><code>grafana.json</code></a>
from the sample directory</li><li>Enter Grafana dashboard ID
<code>19294</code> (<code>Dubbo Observability</code>) and click
<strong>Load</strong></li><li>Or download the JSON from <a
href=https://grafana.com/grafana/dashboards/19294-dubbo- [...]
-</span></span></code></pre></div><p>returns results</p><h3
id=62-hostdockerinternal-not-reachable>6.2 host.docker.internal Not
Reachable</h3><p>Replace it with your actual host IP:</p><ul><li>Update
<code>metrics/prometheus_grafana/prometheus_pull.yml</code></li><li>Update
Grafana data source URL</li></ul><h2 id=7-kubernetes-deployment>7. Kubernetes
Deployment</h2><p>Recommended:</p><blockquote><p>kube-prometheus
-<a
href=https://github.com/prometheus-operator/kube-prometheus>https://github.com/prometheus-operator/kube-prometheus</a></p></blockquote><h3
id=71-create-podmonitor>7.1 Create PodMonitor</h3><p>Create
<code>dubboPodMonitor.yaml</code>:</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>apiVersion</span>: monitoring.c [...]
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: PodMonitor
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: dubbo-pod-monitor
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: monitoring
-</span></span><span style=display:flex><span><span
style=color:#268bd2>spec</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespaceSelector</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>matchNames</span>:
-</span></span><span style=display:flex><span> - dubbo-system
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>selector</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>matchLabels</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>app-type</span>: dubbo
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>podMetricsEndpoints</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>port</span>: metrics
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>path</span>: /prometheus
-</span></span></code></pre></div><h3
id=72-optional-add-rbac-permissions-when-rbac-is-enabled>7.2 Optional: Add RBAC
Permissions When RBAC Is Enabled</h3><p>If your cluster enforces RBAC, grant
Prometheus permission to read Pods in <code>dubbo-system</code>:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>apiVersio [...]
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: Role
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: dubbo-system
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader
-</span></span><span style=display:flex><span><span
style=color:#268bd2>rules</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>apiGroups</span>: [<span
style=color:#2aa198>""</span>]
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>resources</span>: [<span
style=color:#2aa198>"pods"</span>]
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>verbs</span>: [<span
style=color:#2aa198>"get"</span>, <span
style=color:#2aa198>"list"</span>, <span
style=color:#2aa198>"watch"</span>]
-</span></span><span style=display:flex><span>---
-</span></span><span style=display:flex><span><span
style=color:#268bd2>apiVersion</span>: rbac.authorization.k8s.io/v1
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: RoleBinding
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader-binding
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: dubbo-system
-</span></span><span style=display:flex><span><span
style=color:#268bd2>roleRef</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>apiGroup</span>: rbac.authorization.k8s.io
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>kind</span>: Role
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader
-</span></span><span style=display:flex><span><span
style=color:#268bd2>subjects</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>kind</span>: ServiceAccount
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: prometheus-k8s
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: monitoring
-</span></span></code></pre></div><p>If your Prometheus installation uses a
different service account, replace the <code>subjects</code> section
accordingly.</p><h3 id=73-deploy-application>7.3 Deploy Application</h3><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>kubectl
apply -f Deployment.yaml
-</span></span></code></pre></div><h3 id=74-verify>7.4
Verify</h3><p>Visit:</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://<prometheus-nodeport>/targets
-</span></span></code></pre></div><p>Ensure your pods show:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span style=display:flex><span>UP
-</span></span></code></pre></div><h2 id=8-production-recommendations>8.
Production
Recommendations</h2><table><thead><tr><th>Scenario</th><th>Recommended
Mode</th></tr></thead><tbody><tr><td>Long-running
services</td><td>Pull</td></tr><tr><td>Short-lived
jobs</td><td>Push</td></tr><tr><td>Kubernetes</td><td>Pull +
PodMonitor</td></tr><tr><td>Pushgateway usage</td><td>Use
pgw-cleaner</td></tr></tbody></table><h2 id=9-summary>9.
Summary</h2><p>Dubbo-Go provides:</p><ul><li>Pull-based Prome [...]
-<button class="btn btn-primary mb-4
feedback--no">No</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disable
[...]
+</span></span></code></pre></div><ol start=4><li>Start the provider and
consumer:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go
+</span></span></code></pre></div><p>In another terminal:</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_URL</span><span
style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:9091"</span>
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>JOB_NAME</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"dubbo-service"</span>
+</span></span><span style=display:flex><span>go run ./go-client/cmd/main.go
+</span></span></code></pre></div><ol start=5><li>Visit the Pushgateway metrics
endpoint:</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>curl
http://localhost:9091/metrics
+</span></span></code></pre></div><ol start=6><li>Open
<code>http://localhost:9090/targets</code> and verify that the
<code>pushgateway</code> target is <code>UP</code>.</li></ol><p>The sample
registers <code>job_pushed_at_seconds</code> and calls the Pushgateway DELETE
API on graceful shutdown. If the process is killed forcefully, cleanup may not
run. For production, use <a
href=https://github.com/apache/dubbo-go-samples/tree/main/tools/pgw-cleaner
target=_blank>pgw-cleaner</a> or anothe [...]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>evaluation_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span><span
style=color:#268bd2>scrape_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: dubbo-provider
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_timeout</span>: 5s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>metrics_path</span>: /prometheus
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9099'</span>]
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: dubbo-consumer
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_timeout</span>: 5s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>metrics_path</span>: /prometheus
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9097'</span>]
+</span></span></code></pre></div><p><code>host.docker.internal</code> lets the
Prometheus container reach Dubbo-Go processes running on the host. If
Prometheus and the applications run in the same Docker network, replace it with
the container name. On Linux, if this hostname is unavailable, use the host IP
or add a <code>host-gateway</code> mapping in Docker Compose.</p><h3
id=52-pushgateway-configuration>5.2 Pushgateway
Configuration</h3><p><code>prometheus_push.yml</code> scrapes only [...]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>evaluation_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span><span
style=color:#268bd2>scrape_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: <span
style=color:#2aa198>'pushgateway'</span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9091'</span>]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>honor_labels</span>: <span style=color:#cb4b16>true</span>
+</span></span></code></pre></div><p><code>honor_labels: true</code> keeps
labels such as <code>job</code> and <code>instance</code> that were pushed by
the application, which helps Grafana display data by service dimension.</p><h2
id=6-import-the-grafana-dashboard>6. Import the Grafana
Dashboard</h2><ol><li>Open <code>http://localhost:3000</code>. The default
credentials are <code>admin</code> / <code>admin</code>.</li><li>Go to
<code>Home -> Connections -> Data sources</code> and click [...]
+</span></span><span style=display:flex><span>curl
http://localhost:9097/prometheus
+</span></span><span style=display:flex><span>curl http://localhost:9091/metrics
+</span></span></code></pre></div><p>If the host can access them but the
Prometheus container cannot, the issue is usually Docker networking. Replace
<code>host.docker.internal</code> with the real host IP, or add this to the
Prometheus service on Linux:</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>extra_hosts</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#2aa198>"host.docker.internal:host-gateway"</span>
+</span></span></code></pre></div><h3 id=73-grafana-shows-no-data>7.3 Grafana
Shows No Data</h3><p>Confirm that the Prometheus data source passes <code>Save
& test</code>; check <code>http://localhost:9090/targets</code> for
<code>UP</code> targets; then query
<code>dubbo_consumer_requests_succeed_total</code> or
<code>dubbo_provider_requests_total</code> in Prometheus. If the query is
empty, make sure the client is continuously calling the server and wait for one
scrape interval.</p><h3 [...]
+<button class="btn btn-primary mb-4
feedback--no">No</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disable
[...]
<a
href="https://github.com/apache/dubbo-website/new/master/content/en//overview/mannual/golang-sdk/tutorial/observability/rpc_metrics?filename=change-me.md&value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md%60+-+e.g.+%60getting-started.md%60%0A%2A
[...]
<a
href="https://github.com/apache/dubbo-website/issues/new?title=Metrics%20Monitoring";
target=_blank><i class="fab fa-github fa-fw"></i> Create an issue</a>
-<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas
fa-tasks fa-fw"></i> Create project issue</a></div><nav
id=TableOfContents><ul><li><a href=#1-monitoring-architecture>1. Monitoring
Architecture</a><ul><li><a href=#11-pull-mode-recommended-for-production>1.1
Pull Mode (Recommended for production)</a></li><li><a
href=#12-push-mode-for-short-lived-jobs>1.2 Push Mode (For short-lived
jobs)</a></li></ul></li><li><a href=#2-components-overview>2. Components Overvi
[...]
+<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas
fa-tasks fa-fw"></i> Create project issue</a></div><nav
id=TableOfContents><ul><li><a href=#1-monitoring-modes>1. Monitoring
Modes</a><ul><li><a href=#11-pull-mode>1.1 Pull Mode</a></li><li><a
href=#12-pushgateway-mode>1.2 Pushgateway Mode</a></li></ul></li><li><a
href=#2-prepare-the-sample>2. Prepare the Sample</a></li><li><a
href=#3-pull-mode-workflow>3. Pull Mode Workflow</a></li><li><a
href=#4-pushgateway- [...]
<button class="contact-btn qr-container"
onmouseover='showQRCode("dingding-qr")'
onmouseout='hideQRCode("dingding-qr")'>DINGTALK CHANNEL<div class=qr-code
id=dingding-qr style=display:none><img
src=https://img.alicdn.com/imgextra/i4/O1CN01buuadT274Lj33QZWQ_!!6000000007743-0-tps-1170-1477.jpg
alt="DingTalk QR Code"></div></button>
<button class=contact-btn><a
href=https://github.com/apache/dubbo/>GitHub</a></button></div></div><div
class=footer-container-right><ul><li>DOCUMENTATION</li><li><a
href=/en/overview/>Overview</a></li><li><a href=/en/overview/quickstart/>Quick
Start</a></li><li><a
href=/en/contact/contributor/software-donation-guide_dev/>Developer
guide</a></li></ul><ul><li>RESOURCES</li><li><a
href=/en/contact/>Community</a></li></ul></div></div><div
style="width:85.125rem;height:0;border:1px solid #ddd [...]
project logo are either registered trademarks or trademarks of The Apache
Software Foundation in the United States
diff --git a/en/sitemap.xml b/en/sitemap.xml
index a85f5e99116..255554373e1 100644
--- a/en/sitemap.xml
+++ b/en/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/en/blog/2023/01/16/alibaba-upgrades-dubbo3-to-fully-replace-hsf2/</loc><lastmod>2024-09-30T17:53:33+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority><xhtml:link
rel="alternate" hreflang="zh-cn"
href="https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7
[...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/en/blog/2023/01/16/alibaba-upgrades-dubbo3-to-fully-replace-hsf2/</loc><lastmod>2024-09-30T17:53:33+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority><xhtml:link
rel="alternate" hreflang="zh-cn"
href="https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7
[...]
\ No newline at end of file
diff --git a/js/app.js b/js/app.js
index b17e7b31a97..069248774b1 100644
--- a/js/app.js
+++ b/js/app.js
@@ -1,2 +1 @@
-(function(){"use strict";var t={5030:function(t,e,r){var
n=r(2856),o=function(){var t=this,e=t._self._c;return
e("div",{attrs:{id:"app"}},[e("el-row",[e("el-col",{attrs:{span:24}},[e("div",{staticStyle:{"font-size":"30px"}},[t._v("Dubbo
基准测试")])])],1),e("el-row",[e("el-col",{attrs:{span:24}},[e("div",{staticStyle:{"font-size":"15px","text-align":"right"}},[e("a",{attrs:{target:"_blank",href:"https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners/about-
[...]
-//# sourceMappingURL=app.a7f8f515.js.map
\ No newline at end of file
+// Respond to static link checks, which will be dynamically replaced at build
time
\ No newline at end of file
diff --git a/js/chunk-vendors.js b/js/chunk-vendors.js
index e33ee56a2ec..069248774b1 100644
--- a/js/chunk-vendors.js
+++ b/js/chunk-vendors.js
@@ -1,60 +1 @@
-(self["webpackChunkdubbo_benchmark"]=self["webpackChunkdubbo_benchmark"]||[]).push([[504],{1656:function(e,t,n){"use
strict";function i(e,t,n,i,r,o,a,s){var l,u="function"===typeof
e?e.options:e;if(t&&(u.render=t,u.staticRenderFns=n,u._compiled=!0),i&&(u.functional=!0),o&&(u._scopeId="data-v-"+o),a?(l=function(e){e=e||this.$vnode&&this.$vnode.ssrContext||this.parent&&this.parent.$vnode&&this.parent.$vnode.ssrContext,e||"undefined"===typeof
__VUE_SSR_CONTEXT__||(e=__VUE_SSR_CONTEXT__),r&& [...]
-/**
- * @license
- * Lodash <https://lodash.com/>
- * Copyright JS Foundation and other contributors <https://js.foundation/>
- * Released under MIT license <https://lodash.com/license>
- * Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
- * Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters &
Editors
- */(function(){var o,a="4.17.10",s=200,l="Unsupported core-js use. Try
https://npms.io/search?q=ponyfill.",u="Expected a
function",c="__lodash_hash_undefined__",h=500,d="__lodash_placeholder__",p=1,f=2,g=4,v=1,m=2,y=1,b=2,_=4,x=8,w=16,S=32,C=64,k=128,M=256,T=512,D=30,I="...",O=800,A=16,E=1,P=2,L=3,N=1/0,R=9007199254740991,$=17976931348623157e292,z=NaN,V=4294967295,F=V-1,B=V>>>1,j=[["ary",k],["bind",y],["bindKey",b],["curry",x],["curryRight",w],["flip",T],["partial",S],["partialRight",C],
[...]
-/**
- * @fileOverview Kickass library to create and place poppers near their
reference elements.
- * @version {{version}}
- * @license
- * Copyright (c) 2016 Federico Zivolo and contributors
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to
deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE
- * SOFTWARE.
- */(function(o,a){i=a,r="function"===typeof i?i.call(t,n,t,e):i,void
0===r||(e.exports=r)})(0,function(){var
e=window,t={placement:"bottom",gpuAcceleration:!0,offset:0,boundariesElement:"viewport",boundariesPadding:5,preventOverflowOrder:["left","right","top","bottom"],flipBehavior:"flip",arrowElement:"[x-arrow]",arrowOffset:0,modifiers:["shift","offset","preventOverflow","keepTogether","arrow","flip","applyStyle"],modifiersIgnored:[],forceAbsolute:!1};function
n(e,n,i){this._reference=e [...]
-/*!
- * jQuery JavaScript Library v3.7.1
- * https://jquery.com/
- *
- * Copyright OpenJS Foundation and other contributors
- * Released under the MIT license
- * https://jquery.org/license
- *
- * Date: 2023-08-28T13:37Z
- */
-function(t,n){"use strict";"object"===typeof
e.exports?e.exports=t.document?n(t,!0):function(e){if(!e.document)throw new
Error("jQuery requires a window with a document");return
n(e)}:n(t)}("undefined"!==typeof window?window:this,function(n,o){"use
strict";var a=[],s=Object.getPrototypeOf,l=a.slice,u=a.flat?function(e){return
a.flat.call(e)}:function(e){return
a.concat.apply([],e)},c=a.push,h=a.indexOf,d={},p=d.toString,f=d.hasOwnProperty,g=f.toString,v=g.call(Object),m={},y=function(e){
[...]
-/**
- * Checks if an event is supported in the current execution environment.
- *
- * NOTE: This will not work correctly for non-generic events such as `change`,
- * `reset`, `load`, `error`, and `select`.
- *
- * Borrows from Modernizr.
- *
- * @param {string} eventNameSuffix Event name, e.g. "click".
- * @param {?boolean} capture Check if the capture phase is supported.
- * @return {boolean} True if the event is supported.
- * @internal
- * @license Modernizr 3.0.0pre (Custom Build) | MIT
- */
-function o(e,t){if(!r.canUseDOM||t&&!("addEventListener"in
document))return!1;var n="on"+e,o=n in document;if(!o){var
a=document.createElement("div");a.setAttribute(n,"return;"),o="function"===typeof
a[n]}return!o&&i&&"wheel"===e&&(o=document.implementation.hasFeature("Events.wheel","3.0")),o}r.canUseDOM&&(i=document.implementation&&document.implementation.hasFeature&&!0!==document.implementation.hasFeature("","")),e.exports=o},9030:function(e,t,n){"use
strict";var i=n(8656),r=n(2021),o= [...]
-//# sourceMappingURL=chunk-vendors.8eb077c9.js.map
\ No newline at end of file
+// Respond to static link checks, which will be dynamically replaced at build
time
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 020f48e1985..6bfdf17b92c 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2026-08-07T20:51:37+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2026-08-07T20:51:37+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";><sitemap><loc>https://cn.dubbo.apache.org/zh-cn/sitemap.xml</loc><lastmod>2026-08-09T12:45:10+08:00</lastmod></sitemap><sitemap><loc>https://cn.dubbo.apache.org/en/sitemap.xml</loc><lastmod>2026-08-09T12:45:10+08:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
diff --git a/zh-cn/index.xml b/zh-cn/index.xml
index df0a5d3b9a2..613830c0b77 100644
--- a/zh-cn/index.xml
+++ b/zh-cn/index.xml
@@ -13428,63 +13428,51 @@ Dubbo 可支持集群规模步入百万实例层次。</li>
<li>基于 HTTP 的通信模式，加上相对比较完善的入门文档和演示 demo 和
starters，让开发者在第一感觉上更易于上手</li>
</ul>
<p>Spring Cloud 的问题有：</p></description></item><item><title>指标监控
(Metrics)</title><link>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</guid><description><h1
id="dubbo-go-指标监控">Dubbo-Go 指标监控</h1>
-<p>Dubbo-Go 支持采集运行态 Metrics 指标，并接入 <strong>Prometheus +
Grafana</strong> 实现微服务可观测性。</p>
-<p>当前示例支持两种监控模式：</p>
-<ul>
-<li><strong>Pull 模式</strong>：Prometheus 主动抓取 Dubbo-Go
应用暴露的指标，适合长期运行的服务。</li>
-<li><strong>Push 模式</strong>：Dubbo-Go 应用主动将指标推送到
Pushgateway，仅建议用于短生命周期任务。</li>
-</ul>
-<p>示例源码：</p>
+<p>Dubbo-Go 可以采集 RPC、元数据、注册中心、配置中心等运行态指标，并通过 Prometheus 与 Grafana
构建可观测性看板。本文以 <a
href="https://github.com/apache/dubbo-go-samples/tree/main/observability/prometheus_grafana";
target="_blank">dubbo-go-samples/observability/prometheus_grafana</a>
为例，说明 Pull 与 Pushgateway 两种运行方式。</p>
<blockquote>
-<p><a
href="https://github.com/apache/dubbo-go-samples/tree/main/metrics">https://github.com/apache/dubbo-go-samples/tree/main/metrics</a></p>
+<p>说明：部分旧文档或任务描述可能仍写作
<code>metrics/prometheus_grafana</code>，当前 sample 仓库中的实际目录是
<code>observability/prometheus_grafana</code>。</p>
</blockquote>
-<h2 id="1-监控架构说明">1. 监控架构说明</h2>
-<h3 id="11-pull-模式推荐生产模式">1.1 Pull 模式（推荐生产模式）</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go 应用 ---&gt; Prometheus
---&gt; Grafana
-</span></span><span style="display:flex;"><span> (暴露
/metrics 或 /prometheus 接口)
-</span></span></code></pre></div><p>Prometheus
主动抓取 Dubbo-Go 应用指标。</p>
-<h3 id="12-push-模式适用于短生命周期任务">1.2 Push 模式（适用于短生命周期任务）</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go 应用 ---&gt; Pushgateway
---&gt; Prometheus ---&gt; Grafana
-</span></span></code></pre></div><p>应用主动推送指标到
Pushgateway，Prometheus 再拉取。</p>
-<p>Pushgateway 适用于 <strong>短生命周期任务（如 batch / cron
job）</strong>，不推荐用于长期运行的服务。</p>
-<h2 id="2-示例组件说明">2. 示例组件说明</h2>
+<h2 id="1-工作模式">1. 工作模式</h2>
+<h3 id="11-pull-模式">1.1 Pull 模式</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go 应用暴露 /prometheus 或 /metrics
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus 定时拉取
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pull
模式是 Prometheus 的标准模式，适合长期运行的 Dubbo-Go Provider 与 Consumer。当前 sample 中：</p>
<table>
<thead>
<tr>
- <th>组件</th>
- <th>端口</th>
- <th>说明</th>
+ <th>应用</th>
+ <th>指标地址</th>
</tr>
</thead>
<tbody>
<tr>
- <td>Grafana</td>
- <td>3000</td>
- <td>指标可视化</td>
- </tr>
- <tr>
- <td>Prometheus</td>
- <td>9090</td>
- <td>指标存储与查询</td>
- </tr>
- <tr>
- <td>Pushgateway</td>
- <td>9091</td>
- <td>接收应用推送指标</td>
- </tr>
- <tr>
- <td>go-server 指标端口</td>
- <td>本示例中为 9099</td>
- <td>Pull 模式下 Provider 指标暴露端口</td>
+ <td>go-server</td>
+ <td><code>http://localhost:9099/prometheus</code></td>
</tr>
<tr>
- <td>go-client 指标端口</td>
- <td>本示例中为 9097</td>
- <td>Pull 模式下 Consumer 指标暴露端口</td>
+ <td>go-client</td>
+ <td><code>http://localhost:9097/prometheus</code></td>
</tr>
</tbody>
</table>
-<p>如果不使用本示例，而是直接使用 Dubbo-Go 默认配置，则默认指标端点为
<code>http://localhost:9090/metrics</code>。当前 sample 将指标路径改成了
<code>/prometheus</code>。</p></description></item><item><title>注册中心、配置中心和元数据中心</title><link>https://cn.dubbo.apache.org/zh-cn/overview/reference/proposals/registry-config-meta/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/reference/proposals/registry-config-meta/</guid><description><h2
id [...]
+<p>Dubbo-Go 默认指标地址是
<code>http://localhost:9090/metrics</code>。sample 通过
<code>metrics.WithPort(9099)</code>、<code>metrics.WithPort(9097)</code>
和 <code>metrics.WithPath(&quot;/prometheus&quot;)</code>
改成了上面的端口与路径。</p>
+<h3 id="12-pushgateway-模式">1.2 Pushgateway 模式</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go 应用推送指标
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Pushgateway 暂存指标
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus 拉取 Pushgateway
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pushgateway
更适合 batch、cron job 等短生命周期任务。长期运行的服务优先使用 Pull 模式；如果必须使用
Pushgateway，请配合清理机制，避免停止后的旧指标继续留在 Pushgateway
中。</p></description></item><item><title>注册中心、配置中心和元数据中心</title><link>https://cn.dubbo.apache.org/zh-cn/overview/reference/proposals/registry-config-meta/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/reference/proposals/registry-config-meta/<
[...]
<blockquote>
<p>本节侧重描述传统模式下的 Dubbo
部署架构，在云原生背景下的部署架构会有些变化，主要体现在基础设施（Kubernetes、Service Mesh等）会承担更多的职责，
中心化组件如注册中心、元数据中心、配置中心等的职责被集成、运维变得更加简单，但通过强调这些中心化的组件能让我们更容易理解 Dubbo
的工作原理。</p>
diff --git a/zh-cn/overview/mannual/golang-sdk/tutorial/observability/index.xml
b/zh-cn/overview/mannual/golang-sdk/tutorial/observability/index.xml
index 543e11d8331..9b8ec11e329 100644
--- a/zh-cn/overview/mannual/golang-sdk/tutorial/observability/index.xml
+++ b/zh-cn/overview/mannual/golang-sdk/tutorial/observability/index.xml
@@ -47,63 +47,51 @@
<h2 id="2-完全自定义日志">2. 完全自定义日志</h2>
<p>当前 dubbo-go 框架支持 zap、logrus 两个日志框架，如果您想让 dubbo
框架内核使用其他日志框架打印日志，推荐以标准扩展形式增加支持，具体可参考核心库中内置的 <a
href="https://github.com/apache/dubbo-go/tree/main/logger">源码实现</a>。</p></description></item><item><title>指标监控
(Metrics)</title><link>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observ
[...]
-<p>Dubbo-Go 支持采集运行态 Metrics 指标，并接入 <strong>Prometheus +
Grafana</strong> 实现微服务可观测性。</p>
-<p>当前示例支持两种监控模式：</p>
-<ul>
-<li><strong>Pull 模式</strong>：Prometheus 主动抓取 Dubbo-Go
应用暴露的指标，适合长期运行的服务。</li>
-<li><strong>Push 模式</strong>：Dubbo-Go 应用主动将指标推送到
Pushgateway，仅建议用于短生命周期任务。</li>
-</ul>
-<p>示例源码：</p>
+<p>Dubbo-Go 可以采集 RPC、元数据、注册中心、配置中心等运行态指标，并通过 Prometheus 与 Grafana
构建可观测性看板。本文以 <a
href="https://github.com/apache/dubbo-go-samples/tree/main/observability/prometheus_grafana";
target="_blank">dubbo-go-samples/observability/prometheus_grafana</a>
为例，说明 Pull 与 Pushgateway 两种运行方式。</p>
<blockquote>
-<p><a
href="https://github.com/apache/dubbo-go-samples/tree/main/metrics">https://github.com/apache/dubbo-go-samples/tree/main/metrics</a></p>
+<p>说明：部分旧文档或任务描述可能仍写作
<code>metrics/prometheus_grafana</code>，当前 sample 仓库中的实际目录是
<code>observability/prometheus_grafana</code>。</p>
</blockquote>
-<h2 id="1-监控架构说明">1. 监控架构说明</h2>
-<h3 id="11-pull-模式推荐生产模式">1.1 Pull 模式（推荐生产模式）</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go 应用 ---&gt; Prometheus
---&gt; Grafana
-</span></span><span style="display:flex;"><span> (暴露
/metrics 或 /prometheus 接口)
-</span></span></code></pre></div><p>Prometheus
主动抓取 Dubbo-Go 应用指标。</p>
-<h3 id="12-push-模式适用于短生命周期任务">1.2 Push 模式（适用于短生命周期任务）</h3>
-<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-fallback" data-lang="fallback"><span
style="display:flex;"><span>Dubbo-Go 应用 ---&gt; Pushgateway
---&gt; Prometheus ---&gt; Grafana
-</span></span></code></pre></div><p>应用主动推送指标到
Pushgateway，Prometheus 再拉取。</p>
-<p>Pushgateway 适用于 <strong>短生命周期任务（如 batch / cron
job）</strong>，不推荐用于长期运行的服务。</p>
-<h2 id="2-示例组件说明">2. 示例组件说明</h2>
+<h2 id="1-工作模式">1. 工作模式</h2>
+<h3 id="11-pull-模式">1.1 Pull 模式</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go 应用暴露 /prometheus 或 /metrics
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus 定时拉取
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pull
模式是 Prometheus 的标准模式，适合长期运行的 Dubbo-Go Provider 与 Consumer。当前 sample 中：</p>
<table>
<thead>
<tr>
- <th>组件</th>
- <th>端口</th>
- <th>说明</th>
+ <th>应用</th>
+ <th>指标地址</th>
</tr>
</thead>
<tbody>
<tr>
- <td>Grafana</td>
- <td>3000</td>
- <td>指标可视化</td>
- </tr>
- <tr>
- <td>Prometheus</td>
- <td>9090</td>
- <td>指标存储与查询</td>
- </tr>
- <tr>
- <td>Pushgateway</td>
- <td>9091</td>
- <td>接收应用推送指标</td>
- </tr>
- <tr>
- <td>go-server 指标端口</td>
- <td>本示例中为 9099</td>
- <td>Pull 模式下 Provider 指标暴露端口</td>
+ <td>go-server</td>
+ <td><code>http://localhost:9099/prometheus</code></td>
</tr>
<tr>
- <td>go-client 指标端口</td>
- <td>本示例中为 9097</td>
- <td>Pull 模式下 Consumer 指标暴露端口</td>
+ <td>go-client</td>
+ <td><code>http://localhost:9097/prometheus</code></td>
</tr>
</tbody>
</table>
-<p>如果不使用本示例，而是直接使用 Dubbo-Go 默认配置，则默认指标端点为
<code>http://localhost:9090/metrics</code>。当前 sample 将指标路径改成了
<code>/prometheus</code>。</p></description></item><item><title>Kubernetes
生命周期探针</title><link>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/probe/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/probe/</guid><descr
[...]
+<p>Dubbo-Go 默认指标地址是
<code>http://localhost:9090/metrics</code>。sample 通过
<code>metrics.WithPort(9099)</code>、<code>metrics.WithPort(9097)</code>
和 <code>metrics.WithPath(&quot;/prometheus&quot;)</code>
改成了上面的端口与路径。</p>
+<h3 id="12-pushgateway-模式">1.2 Pushgateway 模式</h3>
+<div class="highlight"><pre tabindex="0"
style="color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code
class="language-text" data-lang="text"><span
style="display:flex;"><span>Dubbo-Go 应用推送指标
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Pushgateway 暂存指标
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Prometheus 拉取 Pushgateway
+</span></span><span style="display:flex;"><span> |
+</span></span><span style="display:flex;"><span> v
+</span></span><span
style="display:flex;"><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pushgateway
更适合 batch、cron job 等短生命周期任务。长期运行的服务优先使用 Pull 模式；如果必须使用
Pushgateway，请配合清理机制，避免停止后的旧指标继续留在 Pushgateway
中。</p></description></item><item><title>Kubernetes
生命周期探针</title><link>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/probe/</link><pubDate>Mon,
01 Jan 0001 00:00:00
+0000</pubDate><guid>https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/obser
[...]
<p>Dubbo-Go 提供内置的 <strong>Kubernetes HTTP Probe
服务</strong>，用于支持：</p>
<ul>
<li>✅ <code>liveness</code></li>
diff --git
a/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
b/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
index df2964a6c10..fd9c5af9760 100644
---
a/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
+++
b/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/index.html
@@ -1,4 +1,4 @@
-<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=alternate hreflang=en
href=https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><link
rel=canonical
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><script>var
_paq=window._paq=window._paq||[];_paq.push(["setDocumentTitle",document.domain+"/"+document.title]),_paq.push(["setCookieDomain","*.d
[...]
+<!doctype html><html lang=zh-cn class=no-js><head><meta name=ROBOTS
content="INDEX, FOLLOW"><link rel=alternate hreflang=en
href=https://cn.dubbo.apache.org/en/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><link
rel=canonical
href=https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/observability/rpc_metrics/><script>var
_paq=window._paq=window._paq||[];_paq.push(["setDocumentTitle",document.domain+"/"+document.title]),_paq.push(["setCookieDomain","*.d
[...]
<a class=dropdown-item href=/zh-cn/overview/notices/>安全公告</a>
<a class=dropdown-item href=/zh-cn/contact/>贡献者指南</a></div></li><li
class="nav-item nav-item-line px-2 mb-2 mb-lg-0"><a class=nav-link
href=/zh-cn/blog/><span>博客</span></a></li><li class="nav-item nav-item-line
px-2 mb-2 mb-lg-0"><a class=nav-link
href=/zh-cn/download/><span>下载</span></a></li><li class="nav-item dropdown
d-lg-block"><a class="nav-link dropdown-toggle" href=# id=navbarDropdown
role=button data-toggle=dropdown aria-haspopup=true
aria-expanded=false>生态</a><div class="dropdo [...]
<a class=dropdown-item href=/zh-cn/overview/mannual/control-plane/>可视化控制台</a>
@@ -688,77 +688,89 @@
<label for=m-zh-cnoverviewnoticesprotocol-check><a
href=/zh-cn/overview/notices/protocol/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-zh-cnoverviewnoticesprotocol><span>RPC
协议安全</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child"
id=m-zh-cnoverviewnoticesregistry-li><input type=checkbox
id=m-zh-cnoverviewnoticesregistry-check>
<label for=m-zh-cnoverviewnoticesregistry-check><a
href=/zh-cn/overview/notices/registry/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page"
id=m-zh-cnoverviewnoticesregistry><span>注册中心安全</span></a></label></li><li
class="td-sidebar-nav__section-title td-sidebar-nav__section without-child"
id=m-zh-cnoverviewnoticesadmin-li><input type=checkbox
id=m-zh-cnoverviewnoticesadmin-check>
<label for=m-zh-cnoverviewnoticesadmin-check><a
href=/zh-cn/overview/notices/admin/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-zh-cnoverviewnoticesadmin><span>Dubbo Admin
安全</span></a></label></li><li class="td-sidebar-nav__section-title
td-sidebar-nav__section without-child" id=m-zh-cnoverviewnoticeslog4j-li><input
type=checkbox id=m-zh-cnoverviewnoticeslog4j-check>
-<label for=m-zh-cnoverviewnoticeslog4j-check><a
href=/zh-cn/overview/notices/log4j/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-zh-cnoverviewnoticeslog4j><span>Log4j
漏洞影响</span></a></label></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=/zh-cn/overview/>文档</a></li><li class=breadcrumb-item><a href=/zh-cn/ove
[...]
-</span></span><span style=display:flex><span> (暴露 /metrics 或
/prometheus 接口)
-</span></span></code></pre></div><p>Prometheus 主动抓取 Dubbo-Go 应用指标。</p><h3
id=12-push-模式适用于短生命周期任务>1.2 Push 模式（适用于短生命周期任务）</h3><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>Dubbo-Go 应用 ---> Pushgateway ---> Prometheus
---> Grafana
-</span></span></code></pre></div><p>应用主动推送指标到 Pushgateway，Prometheus
再拉取。</p><p>Pushgateway 适用于 <strong>短生命周期任务（如 batch / cron
job）</strong>，不推荐用于长期运行的服务。</p><h2 id=2-示例组件说明>2.
示例组件说明</h2><table><thead><tr><th>组件</th><th>端口</th><th>说明</th></tr></thead><tbody><tr><td>Grafana</td><td>3000</td><td>指标可视化</td></tr><tr><td>Prometheus</td><td>9090</td><td>指标存储与查询</td></tr><tr><td>Pushgateway</td><td>9091</td><td>接收应用推送指标</td></tr><tr><td>go-server
指标端口</td><td>本示例中为 9099</td><td>Pull 模式下 Provid [...]
-</span></span></code></pre></div><p>启动监控组件：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span
style=display:flex><span>docker-compose up -d
-</span></span></code></pre></div><p>访问地址：</p><ul><li>Grafana: <a
href=http://localhost:3000>http://localhost:3000</a></li><li>Prometheus: <a
href=http://localhost:9090>http://localhost:9090</a></li><li>Pushgateway: <a
href=http://localhost:9091>http://localhost:9091</a></li></ul><h3
id=32-配置环境变量>3.2 配置环境变量</h3><p>客户端与服务端使用相同环境变量：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lan [...]
-</span></span><span style=display:flex><span>
-</span></span><span style=display:flex><span><span style=color:#586e75># Push
模式必需</span>
+<label for=m-zh-cnoverviewnoticeslog4j-check><a
href=/zh-cn/overview/notices/log4j/ class="align-left pl-0 td-sidebar-link
td-sidebar-link__page" id=m-zh-cnoverviewnoticeslog4j><span>Log4j
漏洞影响</span></a></label></li></ul></li></ul></li></ul></nav></div></div><main
class="col-12 col-md-9 col-xl-8 pl-md-5" role=main><nav aria-label=breadcrumb
class=td-breadcrumbs><ol class=breadcrumb><li class=breadcrumb-item><a
href=/zh-cn/overview/>文档</a></li><li class=breadcrumb-item><a href=/zh-cn/ove
[...]
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Prometheus 定时拉取
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pull 模式是 Prometheus 的标准模式，适合长期运行的 Dubbo-Go
Provider 与 Consumer。当前 sample
中：</p><table><thead><tr><th>应用</th><th>指标地址</th></tr></thead><tbody><tr><td>go-server</td><td><code>http://localhost:9099/prometheus</code></td></tr><tr><td>go-client</td><td><code>http://localhost:9097/prometheus</code></td></tr></tbody></table><p>Dubbo-Go
默认指标地址是 <code>http://localhost:9090/metrics</code>。sample 通过
<code>metrics.WithPort(9099)</code>、<code>metrics.WithPort(9097) [...]
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Pushgateway 暂存指标
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Prometheus 拉取 Pushgateway
+</span></span><span style=display:flex><span> |
+</span></span><span style=display:flex><span> v
+</span></span><span style=display:flex><span>Grafana 查询 Prometheus 并展示大盘
+</span></span></code></pre></div><p>Pushgateway 更适合 batch、cron job
等短生命周期任务。长期运行的服务优先使用 Pull 模式；如果必须使用 Pushgateway，请配合清理机制，避免停止后的旧指标继续留在
Pushgateway 中。</p><h2 id=2-准备示例>2. 准备示例</h2><p>克隆 samples 仓库并进入示例目录：</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>git clone
--depth <span style=color:#2aa198>1</span> https://github.com/apache/dubbo-go-
[...]
+</span></span><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span></code></pre></div><p>该目录包含：</p><table><thead><tr><th>文件或目录</th><th>说明</th></tr></thead><tbody><tr><td><code>docker-compose.yml</code></td><td>启动
ZooKeeper、Prometheus、Pushgateway、Grafana</td></tr><tr><td><code>prometheus_pull.yml</code></td><td>Pull
模式的 Prometheus
配置</td></tr><tr><td><code>prometheus_push.yml</code></td><td>Pushgateway 模式的
Prometheus
配置</td></tr><tr><td><code>go-server/cmd/main.go</code></td><td>Provider 示例，RPC
端口 <code>20000</code>，指标端口 <code>9099</code></ [...]
+</span></span></code></pre></div><p>如果你的环境还在使用 Docker Compose v1，可以执行：</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span
style=display:flex><span>docker-compose up -d
+</span></span></code></pre></div><p>启动后可访问：</p><table><thead><tr><th>组件</th><th>地址</th></tr></thead><tbody><tr><td>Grafana</td><td><code>http://localhost:3000</code></td></tr><tr><td>Prometheus</td><td><code>http://localhost:9090</code></td></tr><tr><td>Pushgateway</td><td><code>http://localhost:9091</code></td></tr><tr><td>ZooKeeper</td><td><code>127.0.0.1:2181</code></td></tr></tbody></table><h2
id=3-pull-模式运行流程>3. Pull 模式运行流程</h2><p><code>docker-compose.yml</code> 默认挂载
<code>prometheu [...]
+</span></span></code></pre></div><p>Windows PowerShell 使用：</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-powershell data-lang=powershell><span
style=display:flex><span><span style=color:#268bd2>$env:ZK_ADDRESS</span>=<span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span></code></pre></div><ol start=2><li>启动 Provider：</li></ol><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go --push<span style=color:#719e07>=</span><span
style=color:#b58900>false</span>
+</span></span></code></pre></div><ol start=3><li>新开终端，进入同一目录后启动
Consumer：</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span><span style=display:flex><span>go run ./go-client/cmd/main.go
--push<span style=color:#719e07>=</span><span style=color:#b58900>false</span>
+</span></span></code></pre></div><ol start=4><li>访问应用暴露的指标端点：</li></ol><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>curl
http://localhost:9099/prometheus
+</span></span><span style=display:flex><span>curl
http://localhost:9097/prometheus
+</span></span></code></pre></div><p>输出中可以看到
<code>dubbo_provider_</code>、<code>dubbo_consumer_</code>、<code>dubbo_application_</code>
等指标。例如：</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-text data-lang=text><span
style=display:flex><span>dubbo_provider_requests_total
+</span></span><span
style=display:flex><span>dubbo_consumer_requests_succeed_total
+</span></span></code></pre></div><ol start=5><li>打开
<code>http://localhost:9090/targets</code>，确认 <code>dubbo-provider</code> 与
<code>dubbo-consumer</code> 两个 target 为 <code>UP</code>。</li></ol><h2
id=4-pushgateway-模式运行流程>4. Pushgateway 模式运行流程</h2><p>Pushgateway 模式需要让
Prometheus 拉取 Pushgateway，而不是直接拉取 Dubbo-Go 应用。</p><ol><li>将
<code>docker-compose.yml</code> 中 Prometheus 的配置文件挂载从 Pull 配置改为 Push
配置：</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36 [...]
+</span></span><span style=display:flex><span> -
./prometheus_push.yml:/etc/prometheus/prometheus.yml
+</span></span></code></pre></div><ol start=2><li>重新启动监控组件：</li></ol><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>docker
compose down
+</span></span><span style=display:flex><span>docker compose up -d
+</span></span></code></pre></div><ol start=3><li>设置环境变量：</li></ol><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_URL</span><span
style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:9091"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>JOB_NAME</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"dubbo-service"</span>
</span></span><span style=display:flex><span>
-</span></span><span style=display:flex><span><span style=color:#586e75>#
可选</span>
+</span></span><span style=display:flex><span><span style=color:#586e75># 如果
Pushgateway 开启了 Basic Auth，再设置以下变量</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_USER</span><span
style=color:#719e07>=</span><span style=color:#2aa198>"username"</span>
</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_PASS</span><span
style=color:#719e07>=</span><span style=color:#2aa198>"1234"</span>
-</span></span></code></pre></div><h3 id=33-启动-dubbo-go-服务端>3.3 启动 Dubbo-Go
服务端</h3><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go
-</span></span></code></pre></div><h3 id=34-启动-dubbo-go-客户端>3.4 启动 Dubbo-Go
客户端</h3><h4 id=默认-push-模式>默认 Push 模式</h4><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-client/cmd/main.go
-</span></span></code></pre></div><h4 id=使用-pull-模式>使用 Pull 模式</h4><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-client/cmd/main.go --push<span style=color:#719e07>=</span><span
style=color:#b58900>false</span>
-</span></span><span style=display:flex><span>go run ./go-server/cmd/main.go
--push<span style=color:#719e07>=</span><span style=color:#b58900>false</span>
-</span></span></code></pre></div><h3 id=35-验证指标>3.5 验证指标</h3><h4
id=push-模式>Push 模式</h4><p>访问：</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://localhost:9091/metrics
-</span></span></code></pre></div><h4 id=pull-模式>Pull
模式</h4><p><code><应用端口></code> 指的是 Dubbo-Go 应用自身暴露 Prometheus 指标的 HTTP 端口，不是
Prometheus 或 Pushgateway 的端口。</p><p>在当前 sample
中：</p><ul><li>Provider：<code>http://localhost:9099/prometheus</code></li><li>Consumer：<code>http://localhost:9097/prometheus</code></li></ul><p>这两个端口定义在
<a
href=https://github.com/apache/dubbo-go-samples/blob/main/metrics/prometheus_grafana/prometheus_pull.yml><code>metrics/prometheus_grafana/prometheus_pull.yml
[...]
-</span></span></code></pre></div><ol start=4><li>点击 <strong>Add new data
source</strong></li><li>选择 Prometheus</li><li>填写：</li></ol><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://host.docker.internal:9090
-</span></span></code></pre></div><blockquote><p>说明：<code>host.docker.internal</code>
用于让 Docker 容器访问宿主机网络。如果该地址不可用，请替换为宿主机实际 IP。</p></blockquote><ol start=7><li>点击
Save & Test</li></ol><h3 id=42-导入-dubbo-监控大盘>4.2 导入 Dubbo
监控大盘</h3><ol><li>进入：</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span style=display:flex><span>Home
→ Dashboards → New → Import
-</span></span></code></pre></div><ol
start=2><li>使用以下任一方式导入：</li></ol><ul><li>直接上传 sample 目录中的 <a
href=https://github.com/apache/dubbo-go-samples/blob/main/metrics/prometheus_grafana/grafana.json><code>grafana.json</code></a></li><li>输入
Grafana dashboard ID <code>19294</code>（<code>Dubbo Observability</code>）后点击
<strong>Load</strong></li><li>或从 <a
href=https://grafana.com/grafana/dashboards/19294-dubbo-observability/>Grafana
Labs</a> 下载 JSON 文件再上传</li></ul><ol start=3><li><p>sample 仓库已经直 [...]
-</span></span></code></pre></div><p>是否有数据</p><h3
id=62-hostdockerinternal-无法访问>6.2 host.docker.internal 无法访问</h3><p>请改为实际 IP
地址：</p><ul><li>修改
<code>metrics/prometheus_grafana/prometheus_pull.yml</code></li><li>修改 Grafana
数据源 URL</li></ul><h2 id=7-kubernetes-部署>7. Kubernetes
部署</h2><p>推荐使用：</p><blockquote><p>kube-prometheus
-<a
href=https://github.com/prometheus-operator/kube-prometheus>https://github.com/prometheus-operator/kube-prometheus</a></p></blockquote><h3
id=71-添加-podmonitor>7.1 添加 PodMonitor</h3><p>创建：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>dubboPodMonitor.yaml
-</span></span></code></pre></div><p>内容：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>apiVersion</span>: monitoring.coreos.com/v1
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: PodMonitor
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: dubbo-pod-monitor
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: monitoring
-</span></span><span style=display:flex><span><span
style=color:#268bd2>spec</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespaceSelector</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>matchNames</span>:
-</span></span><span style=display:flex><span> - dubbo-system
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>selector</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>matchLabels</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>app-type</span>: dubbo
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>podMetricsEndpoints</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>port</span>: metrics
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>path</span>: /prometheus
-</span></span></code></pre></div><h3 id=72-可选集群启用-rbac-时补充权限配置>7.2 可选：集群启用
RBAC 时补充权限配置</h3><p>如果集群开启了 RBAC，建议为 Prometheus 增加对 <code>dubbo-system</code>
命名空间内 Pod 的读取权限：</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>apiVersion</span>: rbac.authorization.k8s.io/v1
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: Role
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: dubbo-system
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader
-</span></span><span style=display:flex><span><span
style=color:#268bd2>rules</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>apiGroups</span>: [<span
style=color:#2aa198>""</span>]
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>resources</span>: [<span
style=color:#2aa198>"pods"</span>]
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>verbs</span>: [<span
style=color:#2aa198>"get"</span>, <span
style=color:#2aa198>"list"</span>, <span
style=color:#2aa198>"watch"</span>]
-</span></span><span style=display:flex><span>---
-</span></span><span style=display:flex><span><span
style=color:#268bd2>apiVersion</span>: rbac.authorization.k8s.io/v1
-</span></span><span style=display:flex><span><span
style=color:#268bd2>kind</span>: RoleBinding
-</span></span><span style=display:flex><span><span
style=color:#268bd2>metadata</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader-binding
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: dubbo-system
-</span></span><span style=display:flex><span><span
style=color:#268bd2>roleRef</span>:
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>apiGroup</span>: rbac.authorization.k8s.io
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>kind</span>: Role
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: pod-reader
-</span></span><span style=display:flex><span><span
style=color:#268bd2>subjects</span>:
-</span></span><span style=display:flex><span> - <span
style=color:#268bd2>kind</span>: ServiceAccount
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>name</span>: prometheus-k8s
-</span></span><span style=display:flex><span> <span
style=color:#268bd2>namespace</span>: monitoring
-</span></span></code></pre></div><p>如果你的 Prometheus 安装使用的 ServiceAccount 不是
<code>prometheus-k8s</code>，请按实际名称修改 <code>subjects</code>。</p><h3
id=73-部署应用>7.3 部署应用</h3><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>kubectl
apply -f Deployment.yaml
-</span></span></code></pre></div><h3 id=74-验证>7.4 验证</h3><p>访问：</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span
style=display:flex><span>http://<prometheus-nodeport>/targets
-</span></span></code></pre></div><p>确认 Pod 状态为：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-fallback data-lang=fallback><span style=display:flex><span>UP
-</span></span></code></pre></div><h2 id=8-生产建议>8.
生产建议</h2><table><thead><tr><th>场景</th><th>推荐模式</th></tr></thead><tbody><tr><td>长期运行服务</td><td>Pull</td></tr><tr><td>短生命周期任务</td><td>Push</td></tr><tr><td>K8s
环境</td><td>Pull + PodMonitor</td></tr><tr><td>需要清理能力</td><td>配合
pgw-cleaner</td></tr></tbody></table><h2 id=9-总结>9. 总结</h2><p>Dubbo-Go
当前支持：</p><ul><li>Pull 模式（标准 Prometheus 模式）</li><li>Push
模式（Pushgateway）</li><li>Docker 快速部署</li><li>Kubernetes
PodMonitor</li><li>Grafana 大盘</li><li> [...]
-<button class="btn btn-primary mb-4
feedback--no">否</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled
[...]
+</span></span></code></pre></div><ol start=4><li>启动 Provider 与
Consumer：</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>go run
./go-server/cmd/main.go
+</span></span></code></pre></div><p>新开终端：</p><div class=highlight><pre
tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span><span
style=color:#b58900>cd</span> dubbo-go-samples/observability/prometheus_grafana
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>ZK_ADDRESS</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:2181"</span>
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>PUSHGATEWAY_URL</span><span
style=color:#719e07>=</span><span
style=color:#2aa198>"127.0.0.1:9091"</span>
+</span></span><span style=display:flex><span><span
style=color:#b58900>export</span> <span
style=color:#268bd2>JOB_NAME</span><span style=color:#719e07>=</span><span
style=color:#2aa198>"dubbo-service"</span>
+</span></span><span style=display:flex><span>go run ./go-client/cmd/main.go
+</span></span></code></pre></div><ol start=5><li>访问 Pushgateway
指标：</li></ol><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-bash data-lang=bash><span style=display:flex><span>curl
http://localhost:9091/metrics
+</span></span></code></pre></div><ol start=6><li>打开
<code>http://localhost:9090/targets</code>，确认 <code>pushgateway</code> target 为
<code>UP</code>。</li></ol><p>示例应用注册了
<code>job_pushed_at_seconds</code>，并在优雅退出时调用 Pushgateway DELETE API 清理自身
job。直接强制结束进程时可能来不及清理，生产环境建议配合 <a
href=https://github.com/apache/dubbo-go-samples/tree/main/tools/pgw-cleaner
target=_blank>pgw-cleaner</a> 定期清理过期指标。</p><h2 id=5-prometheus-配置说明>5.
Prometheus 配置说明</h2><h3 id=51-pull-配置>5.1 Pull 配置</h3><p><code>prometh [...]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>evaluation_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span><span
style=color:#268bd2>scrape_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: dubbo-provider
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_timeout</span>: 5s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>metrics_path</span>: /prometheus
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9099'</span>]
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: dubbo-consumer
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_timeout</span>: 5s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>metrics_path</span>: /prometheus
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9097'</span>]
+</span></span></code></pre></div><p><code>host.docker.internal</code> 表示
Prometheus 容器访问宿主机上的 Dubbo-Go 进程。如果 Prometheus 与应用都运行在同一个 Docker
网络内，可改成容器名；如果是在 Linux 环境且该域名不可用，请改成宿主机实际 IP，或在 compose 中增加
<code>host-gateway</code> 映射。</p><h3 id=52-pushgateway-配置>5.2 Pushgateway
配置</h3><p><code>prometheus_push.yml</code> 只抓取 Pushgateway：</p><div
class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang [...]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>evaluation_interval</span>: 15s
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>scrape_interval</span>: 15s
+</span></span><span style=display:flex><span><span
style=color:#268bd2>scrape_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>job_name</span>: <span
style=color:#2aa198>'pushgateway'</span>
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>static_configs</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#268bd2>targets</span>: [<span
style=color:#2aa198>'host.docker.internal:9091'</span>]
+</span></span><span style=display:flex><span> <span
style=color:#268bd2>honor_labels</span>: <span style=color:#cb4b16>true</span>
+</span></span></code></pre></div><p><code>honor_labels: true</code> 会保留应用推送到
Pushgateway 的 <code>job</code>、<code>instance</code> 等标签，便于 Grafana dashboard
按服务维度展示。</p><h2 id=6-grafana-dashboard-导入>6. Grafana dashboard
导入</h2><ol><li>打开 <code>http://localhost:3000</code>，默认账号密码为 <code>admin</code>
/ <code>admin</code>。</li><li>进入 <code>Home -> Connections -> Data
sources</code>，点击 <code>Add new data source</code>。</li><li>选择
<code>Prometheus</code>，数据源地址填写 <code>http://host.docker.interna [...]
+</span></span><span style=display:flex><span>curl
http://localhost:9097/prometheus
+</span></span><span style=display:flex><span>curl http://localhost:9091/metrics
+</span></span></code></pre></div><p>如果宿主机可以访问而 Prometheus 容器访问失败，通常是 Docker
网络地址问题。把 <code>host.docker.internal</code> 改为宿主机实际 IP，或在 Linux Docker Compose
中为 Prometheus 增加：</p><div class=highlight><pre tabindex=0
style=color:#93a1a1;background-color:#002b36;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code
class=language-yaml data-lang=yaml><span style=display:flex><span><span
style=color:#268bd2>extra_hosts</span>:
+</span></span><span style=display:flex><span> - <span
style=color:#2aa198>"host.docker.internal:host-gateway"</span>
+</span></span></code></pre></div><h3 id=73-grafana-显示-no-data>7.3 Grafana 显示
No Data</h3><p>确认 Prometheus 数据源 <code>Save & test</code> 成功；在
<code>http://localhost:9090/targets</code> 确认 target 为 <code>UP</code>；在
Prometheus 查询 <code>dubbo_consumer_requests_succeed_total</code> 或
<code>dubbo_provider_requests_total</code>。如果查询为空，请确认 client 正在持续调用
server，并等待一个 scrape interval。</p><h3 id=74-pushgateway-中有旧-job>7.4 Pushgateway
中有旧 job</h3><p>Pushgateway 默认不会自动删除旧指标。优雅退出 sample 进程可以触发清理逻辑；生产环 [...]
+<button class="btn btn-primary mb-4
feedback--no">否</button></div><script>const
yes=document.querySelector(".feedback--yes"),no=document.querySelector(".feedback--no");document.querySelectorAll(".feedback--link").forEach(e=>{e.href=e.href+window.location.pathname});const
sendFeedback=e=>{gtag||console.log("!gtag"),gtag("event","click",{event_category:"Helpful",event_label:window.location.pathname,value:e})},disableButtons=()=>{yes.disabled=!0,yes.classList.add("feedback--button__disabled
[...]
<a
href="https://github.com/apache/dubbo-website/new/master/content/zh-cn//overview/mannual/golang-sdk/tutorial/observability/rpc_metrics?filename=change-me.md&value=---%0Atitle%3A+%22Long+Page+Title%22%0AlinkTitle%3A+%22Short+Nav+Title%22%0Aweight%3A+100%0Adescription%3A+%3E-%0A+++++Page+description+for+heading+and+indexes.%0A---%0A%0A%23%23+Heading%0A%0AEdit+this+template+to+create+your+new+page.%0A%0A%2A+Give+it+a+good+name%2C+ending+in+%60.md%60+-+e.g.+%60getting-started.md%60%0A
[...]
<a
href="https://github.com/apache/dubbo-website/issues/new?title=%e6%8c%87%e6%a0%87%e7%9b%91%e6%8e%a7%20%28Metrics%29";
target=_blank><i class="fab fa-github fa-fw"></i> 登记问题</a>
-<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas
fa-tasks fa-fw"></i> 提交项目问题</a></div><nav id=TableOfContents><ul><li><a
href=#1-监控架构说明>1. 监控架构说明</a><ul><li><a href=#11-pull-模式推荐生产模式>1.1 Pull
模式（推荐生产模式）</a></li><li><a href=#12-push-模式适用于短生命周期任务>1.2 Push
模式（适用于短生命周期任务）</a></li></ul></li><li><a href=#2-示例组件说明>2. 示例组件说明</a></li><li><a
href=#3-快速开始>3. 快速开始</a><ul><li><a href=#31-启动监控服务栈>3.1 启动监控服务栈</a></li><li><a
href=#32-配置环境变量>3.2 配置环境变量</a></li><li><a href=#3 [...]
+<a href=https://github.com/apache/dubbo/issues/new target=_blank><i class="fas
fa-tasks fa-fw"></i> 提交项目问题</a></div><nav id=TableOfContents><ul><li><a
href=#1-工作模式>1. 工作模式</a><ul><li><a href=#11-pull-模式>1.1 Pull 模式</a></li><li><a
href=#12-pushgateway-模式>1.2 Pushgateway 模式</a></li></ul></li><li><a
href=#2-准备示例>2. 准备示例</a></li><li><a href=#3-pull-模式运行流程>3. Pull
模式运行流程</a></li><li><a href=#4-pushgateway-模式运行流程>4. Pushgateway
模式运行流程</a></li><li><a href=#5-prometheus-配置说明>5. Prometheus 配置说明</ [...]
<button class="contact-btn qr-container"
onmouseover='showQRCode("dingding-qr")'
onmouseout='hideQRCode("dingding-qr")'>钉钉<div class=qr-code id=dingding-qr
style=display:none><img
src=https://img.alicdn.com/imgextra/i4/O1CN01buuadT274Lj33QZWQ_!!6000000007743-0-tps-1170-1477.jpg
alt="DingTalk QR Code"></div></button>
<button class=contact-btn><a
href=https://github.com/apache/dubbo/>GitHub</a></button></div></div><div
class=footer-container-right><ul><li>文档</li><li><a
href=/zh-cn/overview/home/>概览</a></li><li><a
href=/zh-cn/overview/quickstart/>快速开始</a></li><li><a
href=/zh-cn/contact/contributor/software-donation-guide_dev/>开发者指南</a></li></ul><ul><li>资源</li><li><a
href=/zh-cn/contact/>社区</a></li></ul></div></div><div
style="width:85.125rem;height:0;border:1px solid
#dddee4;margin-bottom:32px"></div>< [...]
project logo are either registered trademarks or trademarks of The Apache
Software Foundation in the United States
diff --git a/zh-cn/sitemap.xml b/zh-cn/sitemap.xml
index cc27999c7a5..05dd5fb4c09 100644
--- a/zh-cn/sitemap.xml
+++ b/zh-cn/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-11-28T15:14:12+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority><xhtml:link
rel="alternate" hreflang="en" href="https://cn.dubbo [...]
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset
xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xhtml="http://www.w3.org/1999/xhtml";><url><loc>https://cn.dubbo.apache.org/zh-cn/blog/2023/01/16/%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%8D%87%E7%BA%A7-dubbo3-%E5%85%A8%E9%9D%A2%E5%8F%96%E4%BB%A3-hsf2/</loc><lastmod>2023-11-28T15:14:12+08:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority><xhtml:link
rel="alternate" hreflang="en" href="https://cn.dubbo [...]
\ No newline at end of file
