| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – Dubbo Admin Guide</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/</link><description>Recent content in Dubbo Admin Guide on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://dubbo.apache.org/en/docs/v2.7/admin/ops/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs: Dubbo Admin Functions</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/functions/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/functions/</guid><description> |
| <h2 id="page-search">Page search</h2> |
| <p>If you need to manage a Dubbo service, you need to search it first and open it&rsquo;s management page</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo-search.jpg" alt="/admin-guide/images/dubbo-search.png"></p> |
| <h2 id="service-provider-page">Service provider page</h2> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo-providers.jpg" alt="/admin-guide/images/dubbo-providers.png"></p> |
| <h2 id="service-consumer-page">Service consumer page</h2> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo-consumers.jpg" alt="/admin-guide/images/dubbo-consumers.png"></p> |
| <h2 id="add-route-rule-page">Add route rule page</h2> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo-add-route.jpg" alt="/admin-guide/images/dubbo-add-route.png"></p> |
| <h2 id="add-dynamic-configuration-page">Add dynamic configuration page</h2> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo-add-config.jpg" alt="/admin-guide/images/dubbo-add-config.png"></p></description></item><item><title>Docs: Dubbo Admin Introductions</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/introduction/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/introduction/</guid><description> |
| <p>Now version 0.1 has been released, frontend uses Vue and Vuetify as javascript framework and UI framework, backend uses spring framework, you can deploy the whole project with maven or deploy frontend and backend separately.</p> |
| <h3 id="deploy-the-whole-project-through-maven">Deploy the whole project through maven</h3> |
| <ul> |
| <li>install</li> |
| </ul> |
| <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-sh" data-lang="sh"><span style="display:flex;"><span>git clone https://github.com/apache/dubbo-admin.git |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">cd</span> dubbo-admin |
| </span></span><span style="display:flex;"><span>mvn clean package |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">cd</span> dubbo-admin-distribution/target |
| </span></span><span style="display:flex;"><span>java -jar dubbo-admin-0.1.jar |
| </span></span></code></pre></div><ul> |
| <li>visit<br> |
| <code>http://localhost:8080</code></li> |
| </ul> |
| <h3 id="deploy-frontend-and-backend-separately">Deploy frontend and backend separately</h3> |
| <ul> |
| <li>frontend deploy</li> |
| </ul> |
| <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-sh" data-lang="sh"><span style="display:flex;"><span><span style="color:#b58900">cd</span> dubbo-admin-ui |
| </span></span><span style="display:flex;"><span>npm install |
| </span></span><span style="display:flex;"><span>npm run dev |
| </span></span></code></pre></div><ul> |
| <li>backend deploy</li> |
| </ul> |
| <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-sh" data-lang="sh"><span style="display:flex;"><span><span style="color:#b58900">cd</span> dubbo-admin-server |
| </span></span><span style="display:flex;"><span>mvn clean package |
| </span></span><span style="display:flex;"><span><span style="color:#b58900">cd</span> target |
| </span></span><span style="display:flex;"><span>java -jar dubbo-admin-server-0.1.jar |
| </span></span></code></pre></div><ul> |
| <li>visit<br> |
| http://localhost:8081</li> |
| <li>in this mode, any modify of frontend will be hot reloaded</li> |
| </ul> |
| <h3 id="configuration-1">configuration: <sup id="fnref:1"><a href="#fn:1" class="footnote-ref" role="doc-noteref">1</a></sup></h3> |
| <p>configuration file location</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-sh" data-lang="sh"><span style="display:flex;"><span>dubbo-admin-server/src/main/resources/application.properties |
| </span></span></code></pre></div><p>configuration:</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-properties" data-lang="properties"><span style="display:flex;"><span>admin.config-center<span style="color:#719e07">=</span><span style="color:#2aa198">zookeeper://127.0.0.1:2181</span> |
| </span></span><span style="display:flex;"><span>admin.registry.address<span style="color:#719e07">=</span><span style="color:#2aa198">zookeeper://127.0.0.1:2181</span> |
| </span></span><span style="display:flex;"><span>admin.metadata-report.address<span style="color:#719e07">=</span><span style="color:#2aa198">zookeeper://127.0.0.1:2181</span> |
| </span></span></code></pre></div><p>Same as Dubbo 2.7, you can set the addresses of metadata center and registry center on configuration center, in zookeeper, the path and content are as below:</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-properties" data-lang="properties"><span style="display:flex;"><span><span style="color:#586e75"># /dubbo/config/dubbo/dubbo.properties</span> |
| </span></span><span style="display:flex;"><span>dubbo.registry.address<span style="color:#719e07">=</span><span style="color:#2aa198">zookeeper://127.0.0.1:2181</span> |
| </span></span><span style="display:flex;"><span>dubbo.metadata-report.address<span style="color:#719e07">=</span><span style="color:#2aa198">zookeeper://127.0.0.1:2181</span> |
| </span></span></code></pre></div><p>the addresses in configuration center have higher priority than those in <code>application.properties</code></p> |
| <p>visit documents on github:</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-sh" data-lang="sh"><span style="display:flex;"><span>https://github.com/apache/dubbo-admin |
| </span></span></code></pre></div><div class="footnotes" role="doc-endnotes"> |
| <hr> |
| <ol> |
| <li id="fn:1"> |
| <p>there&rsquo;s no login module in the current version.&#160;<a href="#fnref:1" class="footnote-backref" role="doc-backlink">&#x21a9;&#xfe0e;</a></p> |
| </li> |
| </ol> |
| </div></description></item><item><title>Docs: Service Search And Service Detail</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/search/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/search/</guid><description> |
| <p>Service search is the basic function of Dubbo OPS, you can search by service name, application name and IP address, the service name and application name support wildcard and autocomplete:</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/searchResult.png" alt="searchResult"></p> |
| <p>the service detail page display providers, consumers, medata information is supported in Dubbo 2.7 or higher version:</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/detail.jpg" alt="detail"></p></description></item><item><title>Docs: Service Test</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/test/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/test/</guid><description> |
| <p>please refer to this <a href="https://dubbo.apache.org/en/blog/2019/08/26/service-test/">blog</a></p></description></item><item><title>Docs: API Docs&Test</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/apidocs/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/apidocs/</guid><description> |
| <h2 id="dubbo-api-docs">dubbo api docs</h2> |
| <p>Dubbo api documents, test tools, generate documents according to annotations, and provide test functions</p> |
| <p>Adding some annotations can generate a swagger like document without turning a non web Dubbo project into a web project</p> |
| <h2 id="how-to-use">How to use?</h2> |
| <ol> |
| <li>Dubbo api docs annotation added to method parameters of Dubbo project |
| <ul> |
| <li>Dubbo provider project introduces dubbo-api-docs-core</li> |
| <li>If Dubbo&rsquo;s interface and parameters are a separate jar package project, introduce dubbo-api-docs-annotations</li> |
| <li>Add the annotation @EnableDubboApiDocs to the project startup class (marked with @SpringBootApplication) |
| or configuration class (marked with @Configuration) of the provider project to enable the Dubbo API Docs |
| <ul> |
| <li>In order to avoid increasing the resource consumption in the production environment, it is recommended |
| to create a configuration class to enable Dubbo API Docs, and use it with the @Profile(&ldquo;dev&rdquo;) annotation</li> |
| <li>Of course, Dubbo API Docs consumed a little CPU resources when the project starting and used a little |
| memory for caching. In the future, it will consider putting the contents of the cache into the metadata |
| center</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ol> |
| <h3 id="current-version-same-as-dubbo-version">Current Version: Same as Dubbo version</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>&lt;dependency&gt; |
| </span></span><span style="display:flex;"><span> &lt;groupId&gt;org.apache.dubbo&lt;/groupId&gt; |
| </span></span><span style="display:flex;"><span> &lt;artifactId&gt;dubbo-api-docs-annotations&lt;/artifactId&gt; |
| </span></span><span style="display:flex;"><span> &lt;version&gt;${dubbo-version}&lt;/version&gt; |
| </span></span><span style="display:flex;"><span>&lt;/dependency&gt; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>&lt;dependency&gt; |
| </span></span><span style="display:flex;"><span> &lt;groupId&gt;org.apache.dubbo&lt;/groupId&gt; |
| </span></span><span style="display:flex;"><span> &lt;artifactId&gt;dubbo-api-docs-core&lt;/artifactId&gt; |
| </span></span><span style="display:flex;"><span> &lt;version&gt;${dubbo-version}&lt;/version&gt; |
| </span></span><span style="display:flex;"><span>&lt;/dependency&gt; |
| </span></span></code></pre></div><ol start="2"> |
| <li></li> |
| </ol> |
| <p>Download <a href="https://github.com/apache/dubbo-admin">dubbo-admin</a> <a href="https://github.com/apache/dubbo-admin/releases">Download</a></p> |
| <ol start="3"> |
| <li> |
| <p>Start dubbo-admin</p> |
| </li> |
| <li> |
| <p>Visit: http:// localhost:8080</p> |
| </li> |
| <li> |
| <p>Enter the &ldquo;API Doc&rdquo; module</p> |
| </li> |
| </ol> |
| <h3 id="annotation-use">Annotation use</h3> |
| <ul> |
| <li>@EnableDubboApiDocs: 配制注解, 启用 dubbo api docs 功能</li> |
| <li>@ApiModule: class annotation, dubbo API module information, used to mark the purpose of an interface class module |
| <ul> |
| <li>value: module name</li> |
| <li>apiInterface: Provider implemented interface</li> |
| <li>version: module version</li> |
| </ul> |
| </li> |
| <li>@ApiDoc: method annotation, dubbo API information, used to mark the purpose of an dubbo API |
| <ul> |
| <li>value: API name</li> |
| <li>description: API description(HTML tags available)</li> |
| <li>version: API version</li> |
| <li>responseClassDescription: response class description</li> |
| </ul> |
| </li> |
| <li>@RequestParam: class property/method Parameter annotation, mark request parameters |
| <ul> |
| <li>value: parameter name</li> |
| <li>required: true/false required parameter</li> |
| <li>description: parameter description</li> |
| <li>example: parameter example</li> |
| <li>defaultValue: parameter default value</li> |
| <li>allowableValues: Allowed values. After setting this property, a drop-down list will be generated for the parameter |
| <ul> |
| <li>Note: a drop-down selection box will be generated after using this property</li> |
| <li>Parameters of boolean type do not need to be set with this property. A drop-down list of true / false will be |
| generated by default</li> |
| <li>Parameters of enumeration type will automatically generate a drop-down list. If you do not want to open all |
| enumeration values, you can set this property separately.</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li>@ResponseProperty: Class attribute annotation, mark response parameters |
| <ul> |
| <li>value: parameter name</li> |
| <li>example: example</li> |
| </ul> |
| </li> |
| </ul> |
| <h2 id="involving-repositorys">Involving repositorys</h2> |
| <ul> |
| <li><a href="https://github.com/apache/dubbo-spi-extensions">dubbo-spi-extensions</a> |
| <a href="https://github.com/apache/dubbo-spi-extensions/tree/2.7.x/dubbo-api-docs">\branch: 2.7.x\dubbo-api-docs</a>: |
| Dubbo-Api-Docs related annotation ,annotation parsing</li> |
| <li><a href="https://github.com/KeRan213539/dubbo-admin">dubbo-admin</a>: Dubbo-Api-Docs document display, test function</li> |
| </ul> |
| <h3 id="use-note">Use note</h3> |
| <ul> |
| <li>Get API list direct connection:</li> |
| </ul> |
| <blockquote> |
| <p>Because Dubbo services with different functions may be registered in the same registration center, |
| but the name of the interface used by Dubbo doc is the same, so the interface of Dubbo doc uses direct connection to obtain the list of different interfaces of different functions. |
| The test can be connected directly or through the registration center</p> |
| </blockquote> |
| <ul> |
| <li>The response bean (the return type of the interface) supports custom generics, but only one generic placeholder.</li> |
| <li>About the use of Map: the key of map can only use the basic data type. If the key of map is not the basic data type, |
| the generated key is not in the standard JSON format, and an exception will occur</li> |
| <li>The API&rsquo;s synchronous / asynchronous is from org.apache.dubbo.config.annotation.Service.async</li> |
| </ul> |
| <h2 id="screenshot">Screenshot</h2> |
| <p><img src="https://dubbo.apache.org/imgs/admin/dubbo_docs_en.png" alt="Screenshot"></p></description></item><item><title>Docs: Service Governance And Configuration Management</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/governance/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/governance/</guid><description> |
| <h2 id="service-governance">Service governance</h2> |
| <p>the basic function of service governance is changing the runtime behaviour and routing logic, to do weight configuration and current limiting:</p> |
| <h3 id="application-level-service-governance">application level service governance</h3> |
| <p>In Dubbo 2.6 or earlier version, all service governance rule are in service scope, if you need to make application scope rule, you need to set the same rule for all services under an application, modify and delete need the same operation, this is very unfriendly. In Dubbo 2.7, application scope service governance is supported, condition route(including black white list) and dynamic configuration(including weight, load balance) all support application scope config.</p> |
| <p><img src="https://dubbo.apache.org/imgs/blog/admin/conditionRoute.jpg" alt="condition"></p> |
| <p>picture above is condition route configuration, can create and search by both application name and service name.</p> |
| <h3 id="tag-route">tag route</h3> |
| <p>tag route is a new feature in Dubbo2.7, in application scope, to set different tag on different server, the screenshot is shown as below:</p> |
| <p><img src="https://dubbo.apache.org/imgs/blog/admin/route.jpg" alt="tag"></p> |
| <p>the client can use <code>setAttachment</code> to specify different tag, is the above case, <code>setAttachment(tag1)</code>, the client will choose from the three servers in the picture above. In this way, you can implement features such as traffic isolation and gray release.</p> |
| <h3 id="condition-route">condition route</h3> |
| <p>condition route is a traditional function in Dubbo, now you can create it in either service scope or application scope. Condition route is in <code>yaml</code> format, you can read <a href="../../../user/examples/routing-rule/">here</a> to find more.</p> |
| <h3 id="black-white-list">black white list</h3> |
| <p>black white list is a part of condition route and store with condition route together, you can set black list or white list, in either service scope or application scope:</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/blackList.jpg" alt="blackList"></p> |
| <h3 id="dynamic-configuration">dynamic configuration</h3> |
| <p>dynamic configuration has the same level with routing rule, it can change the RPC behaviour dynamically without restart service. It supports application scope since Dubbo 2,7, in Dubbo format, the screen shot shows in below:</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/config.jpg" alt="config"></p> |
| <p>to read more, please refer <a href="../../../user/examples/config-rule/">here</a></p> |
| <h3 id="weight-adjust">weight adjust</h3> |
| <p>weigth adjuest is part of dynamic configuration, change the weight of server side to do traffic control dynamically:</p> |
| <p><img src="https://dubbo.apache.org/imgs/admin/weight.jpg" alt="weight"></p> |
| <h3 id="load-balancing">load balancing</h3> |
| <p>load balancing is also poart of dynamic configuration, to specify the route strategy in client side. now we have three strategies: random, least active and round robin, to read more, please refer <a href="../../../user/examples/loadbalance">here</a></p> |
| <h2 id="configuration-management">configuration management</h2> |
| <p>configuration management is also a new feaature for Dubbo 2.7. In Dubbo 2.7, we can specify configurations in global scope and application scope(including services in application), you can view, modify and create new configurations in Dubbo Admin.</p> |
| <ul> |
| <li>global configuration:</li> |
| </ul> |
| <p><img src="https://dubbo.apache.org/imgs/blog/admin/config.jpg" alt="config"></p> |
| <p>you can set registry center, metadata center, timeout for provider and consumer in global configurations. If the implementation of registry center and metadata center is zookeeper, you can also check the location of configuration file.</p> |
| <ul> |
| <li>application and service scope configuration:</li> |
| </ul> |
| <p><img src="https://dubbo.apache.org/imgs/blog/admin/appConfig.jpg" alt="appConfig"></p> |
| <p>application configuration can also set service configuration in this application. you need to specify consumer and provider in service scope: <code>dubbo.reference.{serviceName}</code>stands for configuration as consumer side，<code>dubbo.provider.{servcieName}</code>stands for configuration as provider side. the address of registry address and metadata center address can only be configured in global configuration, which is also the recommendation way in Dubbo 2.7</p> |
| <ul> |
| <li>priority service configuration &gt; application configuration &gt; global configuration</li> |
| </ul></description></item><item><title>Docs: Tracking with Pinpoint</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/pinpoint/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/pinpoint/</guid><description> |
| <p>After using Dubbo to serve or integrate applications, assuming that a service backstage log shows an exception and that the service is invoked by multiple applications, it is often difficult to determine which application is called, and what is the cause of the problem, so we need a set of distributed tracking systems to quickly locate the problem. Pinpoint can help us quickly locate problems (of course, there are more than one solution).</p> |
| <h2 id="what-is-pinpoint">What is Pinpoint</h2> |
| <p><a href="https://github.com/naver/pinpoint">Pinpoint</a> is an APM (Application Performance Management) tool for large-scale distributed systems written in Java. Inspired by Dapper, Pinpoint provides a solution to help analyze the overall structure of the system and how components within them are interconnected by tracing transactions across distributed applications.</p> |
| <p>You should definitely check Pinpoint out If you want to</p> |
| <p>understand your application topology at a glance |
| monitor your application in Real-Time |
| gain code-level visibility to every transaction |
| install APM Agents without changing a single line of code |
| have minimal impact on the performance (approximately 3% increase in resource usage)</p> |
| <h3 id="servermap">ServerMap</h3> |
| <p>Understand the topology of any distributed systems by visualizing how their components are interconnected. Clicking on a node reveals details about the component, such as its current status, and transaction count.</p> |
| <h3 id="realtime-active-thread-chart">Realtime Active Thread Chart</h3> |
| <p>Monitor active threads inside applications in real-time.</p> |
| <h3 id="requestresponse-scatter-chart">Request/Response Scatter Chart</h3> |
| <p>Visualize request count and response patterns over time to identify potential problems. Transactions can be selected for additional detail by dragging over the chart.</p> |
| <h3 id="callstack">CallStack</h3> |
| <p>Gain code-level visibility to every transaction in a distributed environment, identifying bottlenecks and points of failure in a single view.</p> |
| <h3 id="inspector">Inspector</h3> |
| <p>View additional details on the application such as CPU usage, Memory/Garbage Collection, TPS, and JVM arguments.</p> |
| <h3 id="supported-modules-last-updated-20180401">Supported Modules (last updated 2018/04/01)</h3> |
| <ul> |
| <li>JDK 6+</li> |
| <li>Tomcat 6/7/8, Jetty 8/9, JBoss EAP 6, Resin 4, Websphere 6/7/8, Vertx 3.3/3.4/3.5</li> |
| <li>Spring, Spring Boot (Embedded Tomcat, Jetty)</li> |
| <li>Apache HTTP Client 3.x/4.x, JDK HttpConnector, GoogleHttpClient, OkHttpClient, NingAsyncHttpClient</li> |
| <li>Thrift Client, Thrift Service, DUBBO PROVIDER, DUBBO CONSUMER</li> |
| <li>ActiveMQ, RabbitMQ</li> |
| <li>MySQL, Oracle, MSSQL, CUBRID,POSTGRESQL, MARIA</li> |
| <li>Arcus, Memcached, Redis, CASSANDRA</li> |
| <li>iBATIS, MyBatis</li> |
| <li>DBCP, DBCP2, HIKARICP</li> |
| <li>gson, Jackson, Json Lib</li> |
| <li>log4j, Logback</li> |
| </ul> |
| <h2 id="pinpoint-and-dubbo">Pinpoint and Dubbo</h2> |
| <h3 id="quickstart-pinpoint">Quickstart Pinpoint</h3> |
| <p><a href="https://pinpoint-apm.github.io/pinpoint/quickstart.html">Quick start</a>（No neet to start TestApp）</p> |
| <h3 id="dubbo-demo">Dubbo demo</h3> |
| <h4 id="create-api-module">Create API module</h4> |
| <p>pom.xml</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-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#719e07">&lt;?xml version=&#34;1.0&#34; encoding=&#34;UTF-8&#34;?&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;project</span> xmlns=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0&#34;</span> |
| </span></span><span style="display:flex;"><span> xmlns:xsi=<span style="color:#2aa198">&#34;http://www.w3.org/2001/XMLSchema-instance&#34;</span> |
| </span></span><span style="display:flex;"><span> xsi:schemaLocation=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;modelVersion&gt;</span>4.0.0<span style="color:#268bd2">&lt;/modelVersion&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.example<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>demo-api<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.0.1-SNAPSHOT<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;/project&gt;</span> |
| </span></span></code></pre></div><p>Create API interface：</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-go" data-lang="go"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.example.demoapi; |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span>public <span style="color:#268bd2">interface</span> HelloService { |
| </span></span><span style="display:flex;"><span> String <span style="color:#268bd2">sayHello</span>(String name); |
| </span></span><span style="display:flex;"><span>} |
| </span></span></code></pre></div><h4 id="dubbo-provider">Dubbo provider</h4> |
| <p>pom.xml</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-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#719e07">&lt;?xml version=&#34;1.0&#34; encoding=&#34;UTF-8&#34;?&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;project</span> xmlns=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0&#34;</span> xmlns:xsi=<span style="color:#2aa198">&#34;http://www.w3.org/2001/XMLSchema-instance&#34;</span> |
| </span></span><span style="display:flex;"><span> xsi:schemaLocation=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;modelVersion&gt;</span>4.0.0<span style="color:#268bd2">&lt;/modelVersion&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.example<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>demo-provider<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.0.1-SNAPSHOT<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;packaging&gt;</span>jar<span style="color:#268bd2">&lt;/packaging&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;name&gt;</span>demo-provider<span style="color:#268bd2">&lt;/name&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;parent&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter-parent<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>2.0.3.RELEASE<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;relativePath/&gt;</span> <span style="color:#586e75">&lt;!-- lookup parent from repository --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/parent&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;properties&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;project.build.sourceEncoding&gt;</span>UTF-8<span style="color:#268bd2">&lt;/project.build.sourceEncoding&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;project.reporting.outputEncoding&gt;</span>UTF-8<span style="color:#268bd2">&lt;/project.reporting.outputEncoding&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;java.version&gt;</span>1.8<span style="color:#268bd2">&lt;/java.version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/properties&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;repositories&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;repository&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;id&gt;</span>sonatype-nexus-snapshots<span style="color:#268bd2">&lt;/id&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;url&gt;</span>https://oss.sonatype.org/content/repositories/snapshots<span style="color:#268bd2">&lt;/url&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;releases&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;enabled&gt;</span>false<span style="color:#268bd2">&lt;/enabled&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/releases&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;snapshots&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;enabled&gt;</span>true<span style="color:#268bd2">&lt;/enabled&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/snapshots&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/repository&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/repositories&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependencies&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.alibaba.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>dubbo-spring-boot-starter<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.2.0<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.example<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>demo-api<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.0.1-SNAPSHOT<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter-test<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;scope&gt;</span>test<span style="color:#268bd2">&lt;/scope&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependencies&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;build&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;plugins&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;plugin&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-maven-plugin<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/plugin&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/plugins&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/build&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;/project&gt;</span> |
| </span></span></code></pre></div><ol> |
| <li><code>HelloService</code> interface：</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.example.demoprovider.provider<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.annotation.Service<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> com.example.demoapi.HelloService<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@Service</span><span style="color:#719e07">(</span>version <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${demo.service.version}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> application <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.application.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> protocol <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.protocol.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> registry <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.registry.id}&#34;</span><span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">HelloServiceImpl</span> <span style="color:#268bd2">implements</span> HelloService <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">int</span> i <span style="color:#719e07">=</span> 0<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@Override</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> String <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>String name<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> i<span style="color:#719e07">++;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> <span style="color:#719e07">(</span>i <span style="color:#719e07">%</span> 3 <span style="color:#719e07">==</span> 0<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">throw</span> <span style="color:#719e07">new</span> RuntimeException<span style="color:#719e07">(</span><span style="color:#2aa198">&#34;ex&#34;</span><span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#2aa198">&#34;Hello &#34;</span> <span style="color:#719e07">+</span> name <span style="color:#719e07">+</span> <span style="color:#2aa198">&#34;!&#34;</span><span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="2"> |
| <li>Spring Boot bootstrap：</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.example.demoprovider<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.boot.SpringApplication<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.boot.autoconfigure.SpringBootApplication<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@SpringBootApplication</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">DemoProviderApplication</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> SpringApplication<span style="color:#719e07">.</span>run<span style="color:#719e07">(</span>DemoProviderApplication<span style="color:#719e07">.</span>class<span style="color:#719e07">,</span> args<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="3"> |
| <li><code>application.properties</code>：</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-properties" data-lang="properties"><span style="display:flex;"><span><span style="color:#586e75"># Spring boot application</span> |
| </span></span><span style="display:flex;"><span>spring.application.name <span style="color:#719e07">=</span> <span style="color:#2aa198">dubbo-provider-demo</span> |
| </span></span><span style="display:flex;"><span>server.port <span style="color:#719e07">=</span> <span style="color:#2aa198">9090</span> |
| </span></span><span style="display:flex;"><span>management.port <span style="color:#719e07">=</span> <span style="color:#2aa198">9091</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Service version</span> |
| </span></span><span style="display:flex;"><span>demo.service.version <span style="color:#719e07">=</span> <span style="color:#2aa198">1.0.0</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Base packages to scan Dubbo Components (e.g @Service , @Reference)</span> |
| </span></span><span style="display:flex;"><span>dubbo.scan.basePackages <span style="color:#719e07">=</span> <span style="color:#2aa198">com.example.demoprovider</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Dubbo Config properties</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">## ApplicationConfig Bean</span> |
| </span></span><span style="display:flex;"><span>dubbo.application.id <span style="color:#719e07">=</span> <span style="color:#2aa198">dubbo-provider-demo</span> |
| </span></span><span style="display:flex;"><span>dubbo.application.name <span style="color:#719e07">=</span> <span style="color:#2aa198">dubbo-provider-demo</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">## ProtocolConfig Bean</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.id <span style="color:#719e07">=</span> <span style="color:#2aa198">dubbo</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.name <span style="color:#719e07">=</span> <span style="color:#2aa198">dubbo</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.port <span style="color:#719e07">=</span> <span style="color:#2aa198">12345</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">## RegistryConfig Bean</span> |
| </span></span><span style="display:flex;"><span>dubbo.registry.id <span style="color:#719e07">=</span> <span style="color:#2aa198">my-registry</span> |
| </span></span><span style="display:flex;"><span>dubbo.registry.address <span style="color:#719e07">=</span> <span style="color:#2aa198">N/A</span> |
| </span></span></code></pre></div><h4 id="dubbo-consumer">Dubbo consumer</h4> |
| <p>pom.xml</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-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#719e07">&lt;?xml version=&#34;1.0&#34; encoding=&#34;UTF-8&#34;?&gt;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;project</span> xmlns=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0&#34;</span> xmlns:xsi=<span style="color:#2aa198">&#34;http://www.w3.org/2001/XMLSchema-instance&#34;</span> |
| </span></span><span style="display:flex;"><span> xsi:schemaLocation=<span style="color:#2aa198">&#34;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd&#34;</span><span style="color:#268bd2">&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;modelVersion&gt;</span>4.0.0<span style="color:#268bd2">&lt;/modelVersion&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.example<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>demo-consumer<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.0.1-SNAPSHOT<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;packaging&gt;</span>jar<span style="color:#268bd2">&lt;/packaging&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;name&gt;</span>demo-consumer<span style="color:#268bd2">&lt;/name&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;parent&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter-parent<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>2.0.3.RELEASE<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;relativePath/&gt;</span> <span style="color:#586e75">&lt;!-- lookup parent from repository --&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/parent&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;properties&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;project.build.sourceEncoding&gt;</span>UTF-8<span style="color:#268bd2">&lt;/project.build.sourceEncoding&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;project.reporting.outputEncoding&gt;</span>UTF-8<span style="color:#268bd2">&lt;/project.reporting.outputEncoding&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;java.version&gt;</span>1.8<span style="color:#268bd2">&lt;/java.version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/properties&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;repositories&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;repository&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;id&gt;</span>sonatype-nexus-snapshots<span style="color:#268bd2">&lt;/id&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;url&gt;</span>https://oss.sonatype.org/content/repositories/snapshots<span style="color:#268bd2">&lt;/url&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;releases&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;enabled&gt;</span>false<span style="color:#268bd2">&lt;/enabled&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/releases&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;snapshots&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;enabled&gt;</span>true<span style="color:#268bd2">&lt;/enabled&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/snapshots&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/repository&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/repositories&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependencies&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter-web<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.alibaba.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>dubbo-spring-boot-starter<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.2.0<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>com.example<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>demo-api<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;version&gt;</span>0.0.1-SNAPSHOT<span style="color:#268bd2">&lt;/version&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-starter-test<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;scope&gt;</span>test<span style="color:#268bd2">&lt;/scope&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependency&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/dependencies&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;build&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;plugins&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;plugin&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;groupId&gt;</span>org.springframework.boot<span style="color:#268bd2">&lt;/groupId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;artifactId&gt;</span>spring-boot-maven-plugin<span style="color:#268bd2">&lt;/artifactId&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;configuration&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;classifier&gt;</span>exec<span style="color:#268bd2">&lt;/classifier&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/configuration&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/plugin&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/plugins&gt;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">&lt;/build&gt;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">&lt;/project&gt;</span> |
| </span></span></code></pre></div><ol> |
| <li><code>@Reference</code> injection <code>HelloService</code></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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.example.democonsumer.controller<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.apache.dubbo.config.annotation.Reference<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> com.example.demoapi.HelloService<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.web.bind.annotation.RequestMapping<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.web.bind.annotation.RequestParam<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.web.bind.annotation.RestController<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@RestController</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">DemoConsumerController</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@Reference</span><span style="color:#719e07">(</span>version <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${demo.service.version}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> application <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.application.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> url <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;dubbo://&lt;Real IP Address&gt;:12345&#34;</span><span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> HelloService helloService<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@RequestMapping</span><span style="color:#719e07">(</span><span style="color:#2aa198">&#34;/sayHello&#34;</span><span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> String <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span><span style="color:#268bd2">@RequestParam</span> String name<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> helloService<span style="color:#719e07">.</span>sayHello<span style="color:#719e07">(</span>name<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="2"> |
| <li>Spring Boot bootstrap:</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> com.example.democonsumer<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.boot.SpringApplication<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">import</span> org.springframework.boot.autoconfigure.SpringBootApplication<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@SpringBootApplication</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">DemoConsumerApplication</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">void</span> <span style="color:#268bd2">main</span><span style="color:#719e07">(</span>String<span style="color:#719e07">[]</span> args<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> SpringApplication<span style="color:#719e07">.</span>run<span style="color:#719e07">(</span>DemoConsumerApplication<span style="color:#719e07">.</span>class<span style="color:#719e07">,</span> args<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><ol start="3"> |
| <li><code>application.properties</code>:</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-properties" data-lang="properties"><span style="display:flex;"><span><span style="color:#586e75"># Spring boot application</span> |
| </span></span><span style="display:flex;"><span>spring.application.name<span style="color:#719e07">=</span><span style="color:#2aa198">dubbo-consumer-demo</span> |
| </span></span><span style="display:flex;"><span>server.port<span style="color:#719e07">=</span><span style="color:#2aa198">8080</span> |
| </span></span><span style="display:flex;"><span>management.port<span style="color:#719e07">=</span><span style="color:#2aa198">8081</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Service Version</span> |
| </span></span><span style="display:flex;"><span>demo.service.version<span style="color:#719e07">=</span><span style="color:#2aa198">1.0.0</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75"># Dubbo Config properties</span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">## ApplicationConfig Bean</span> |
| </span></span><span style="display:flex;"><span>dubbo.application.id<span style="color:#719e07">=</span><span style="color:#2aa198">dubbo-consumer-demo</span> |
| </span></span><span style="display:flex;"><span>dubbo.application.name<span style="color:#719e07">=</span><span style="color:#2aa198">dubbo-consumer-demo</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#586e75">## ProtocolConfig Bean</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.id<span style="color:#719e07">=</span><span style="color:#2aa198">dubbo</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.name<span style="color:#719e07">=</span><span style="color:#2aa198">dubbo</span> |
| </span></span><span style="display:flex;"><span>dubbo.protocol.port<span style="color:#719e07">=</span><span style="color:#2aa198">12345</span> |
| </span></span></code></pre></div><h3 id="using-pinpoint-agent-to-start-dubbo-provider-and-dubbo-consumer">Using Pinpoint-agent to start <code>Dubbo provider</code> and <code>Dubbo consumer</code></h3> |
| <ol> |
| <li>Maven clean package</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>mvn clean package |
| </span></span></code></pre></div><ol start="2"> |
| <li>Start 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-fallback" data-lang="fallback"><span style="display:flex;"><span>java -jar -javaagent:$AGENT_PATH/pinpoint-bootstrap-$VERSION.jar -Dpinpoint.agentId=demo-provider -Dpinpoint.applicationName=DP target/demo-provider-0.0.1-SNAPSHOT.jar |
| </span></span></code></pre></div><ol start="3"> |
| <li>Start 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-fallback" data-lang="fallback"><span style="display:flex;"><span>java -jar -javaagent:$AGENT_PATH/pinpoint-bootstrap-$VERSION.jar -Dpinpoint.agentId=demo-consumer -Dpinpoint.applicationName=DC target/demo-comsumer-0.0.1-SNAPSHOT-exec.jar |
| </span></span></code></pre></div><ol start="4"> |
| <li>Access the consumer address to simulate user requests</li> |
| </ol> |
| <p><code>http://localhost:8080/sayHello?name=ABC</code></p> |
| <h2 id="using-pinpoint-locate-problems">Using Pinpoint locate problems</h2> |
| <h3 id="homepage">Homepage</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/pinpoint-home.png" alt="/admin-guide/images/pinpoint-home.png"></p> |
| <blockquote> |
| <p>The user request here is double the number of requests for DubboProvider, because the favicon.ico icon request is recorded.</p> |
| </blockquote> |
| <h3 id="call-tree">Call tree</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/pinpoint-calltree.png" alt="/admin-guide/images/pinpoint-calltree.png"></p> |
| <h3 id="mixed-view">Mixed view</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/pinpoint-mixedview.png" alt="/admin-guide/images/pinpoint-mixedview.png"></p> |
| <h3 id="other">Other</h3> |
| <p>The example simply simulates the provision and call of Dubbo, and does not carry out the application of other middleware such as database. For detailed use, please refer to the Pinpoint document.</p></description></item><item><title>Docs: Tracing Dubbo service with Apache Skywalking</title><link>https://dubbo.apache.org/en/docs/v2.7/admin/ops/skywalking/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/en/docs/v2.7/admin/ops/skywalking/</guid><description> |
| <h2 id="introduction-to-apache-skywalking">Introduction to Apache Skywalking</h2> |
| <p><a href="https://github.com/apache/skywalking">Apache Skywalking(Incubator)</a> is the APM system that it designed for micro-services architectures and cloud native architecture systems and supports distribute tracking. <a href="https://github.com/apache/skywalking">Apache skywalking (incubator)</a> collects and analyzes the trace data and generates the relationship between the application and the service metric, Apache skywalking supports multiple languages agent, for example <a href="https://github.com/apache/skywalking">Java</a>,<a href="https://github.com/OpenSkywalking/skywalking-netcore">.net core</a>,<a href="https://github.com/OpenSkywalking/skywalking-nodejs">Node.js</a> and <a href="https://github.com/SkyAPM/go2sky">Go</a>.</p> |
| <p>Currently, Skywalking has supported analysis the operation of distributed systems from 6 visual dimensions. The overview view is a global view of your applications and components, including the number of components and applications, application alarm fluctuations, slow service lists, and application throughput; The topology shows the topological relationship of the whole application; The application view represents the upstream and downstream relationship of the application from single application, TOP N services and servers, JVM, host and process info. The service view focuses on the operation of a single service portal and the upstream and downstream dependencies of this service and it helps the user to optimize and monitor a single service; the trace graph shows all the buried points of the invocation and the execution time of each burial point, and the alarm view is based on the configuration threshold for the application, server, service for real-time alarms</p> |
| <h2 id="dubbo-and-apache-skywalking">Dubbo and Apache Skywalking</h2> |
| <h3 id="build-the-dubbo-demo--project">Build the Dubbo demo project</h3> |
| <p>The Dubbo demo has been uploaded to the <a href="https://github.com/SkywalkingTest/dubbo-trace-example">GitHub repository</a>.</p> |
| <h4 id="api-project">API project</h4> |
| <p>Service interface definition:</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.skywalking.demo.interfaces<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">interface</span> <span style="color:#268bd2">HelloService</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> String <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>String name<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h4 id="service-provider-project">Service provider project</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.skywalking.demo.provider<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@Service</span><span style="color:#719e07">(</span>version <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${demo.service.version}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> application <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.application.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> protocol <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.protocol.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> registry <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.registry.id}&#34;</span><span style="color:#719e07">,</span> timeout <span style="color:#719e07">=</span> 60000<span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">HelloServiceImpl</span> <span style="color:#268bd2">implements</span> HelloService <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> String <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span>String name<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> LockSupport<span style="color:#719e07">.</span>parkNanos<span style="color:#719e07">(</span>TimeUnit<span style="color:#719e07">.</span>SECONDS<span style="color:#719e07">.</span>toNanos<span style="color:#719e07">(</span>1<span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> <span style="color:#2aa198">&#34;Hello, &#34;</span> <span style="color:#719e07">+</span> name<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h4 id="service-consumer-project">Service consumer project</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-java" data-lang="java"><span style="display:flex;"><span><span style="color:#719e07">package</span> org.apache.skywalking.demo.consumer<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">@RestController</span> |
| </span></span><span style="display:flex;"><span><span style="color:#268bd2">public</span> <span style="color:#268bd2">class</span> <span style="color:#268bd2">ConsumerController</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> <span style="color:#268bd2">static</span> <span style="color:#dc322f">int</span> COUNT <span style="color:#719e07">=</span> 0<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@Reference</span><span style="color:#719e07">(</span>version <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${demo.service.version}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> application <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;${dubbo.application.id}&#34;</span><span style="color:#719e07">,</span> |
| </span></span><span style="display:flex;"><span> url <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;dubbo://localhost:20880&#34;</span><span style="color:#719e07">,</span> timeout <span style="color:#719e07">=</span> 60000<span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">private</span> HelloService helloService<span style="color:#719e07">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">@GetMapping</span><span style="color:#719e07">(</span><span style="color:#2aa198">&#34;/sayHello/{name}&#34;</span><span style="color:#719e07">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#268bd2">public</span> String <span style="color:#268bd2">sayHello</span><span style="color:#719e07">(</span><span style="color:#268bd2">@PathVariable</span><span style="color:#719e07">(</span>name <span style="color:#719e07">=</span> <span style="color:#2aa198">&#34;name&#34;</span><span style="color:#719e07">)</span> String name<span style="color:#719e07">)</span> <span style="color:#719e07">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">if</span> <span style="color:#719e07">((</span>COUNT<span style="color:#719e07">++)</span> <span style="color:#719e07">%</span> 3 <span style="color:#719e07">==</span> 0<span style="color:#719e07">){</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">throw</span> <span style="color:#719e07">new</span> RuntimeException<span style="color:#719e07">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span> LockSupport<span style="color:#719e07">.</span>parkNanos<span style="color:#719e07">(</span>TimeUnit<span style="color:#719e07">.</span>SECONDS<span style="color:#719e07">.</span>toNanos<span style="color:#719e07">(</span>2<span style="color:#719e07">));</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">return</span> helloService<span style="color:#719e07">.</span>sayHello<span style="color:#719e07">(</span>name<span style="color:#719e07">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#719e07">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#719e07">}</span> |
| </span></span></code></pre></div><h3 id="deploy-apache-skywalking">Deploy Apache Skywalking</h3> |
| <p><a href="https://github.com/apache/skywalking">Apache skywalking (Incubator)</a> offers two deployment modes: single-node mode and cluster mode,Here is the single-node mode deployment step, and more about how to deploy skywalking with cluster mode, please reference <a href="https://skywalking.apache.org/docs/main/next/en/setup/backend/backend-setup/">document</a>.</p> |
| <h4 id="third-party-components">Third-party components</h4> |
| <ol> |
| <li>JDK 8+</li> |
| <li>Elasticsearch 5.x</li> |
| </ol> |
| <h4 id="deployment-step">Deployment step</h4> |
| <ol> |
| <li>Download <a href="http://skywalking.apache.org/downloads/">Apache Skywalking Collector</a></li> |
| <li>Deploy Elasticsearch service |
| <ul> |
| <li>Set <code>cluster.name</code> to <code>CollectorDBCluster</code></li> |
| <li>Set <code>network.host</code> to <code>0.0.0.0</code></li> |
| <li>Start elasticsearch service</li> |
| </ul> |
| </li> |
| <li>Unzip and start the Skywalking Collector. Run the &rsquo; bin/startup.sh &rsquo; command to start skywalking Collector</li> |
| </ol> |
| <h4 id="deploy-the-demo">Deploy the demo</h4> |
| <p>Before you deploy the demo service, please run the following command:</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>./mvnw clean package |
| </span></span></code></pre></div><h4 id="deploy-the-provider-service">Deploy the provider service</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>java -jar -javaagent:<span style="color:#268bd2">$AGENT_PATH</span>/skywalking-agent.jar -Dskywalking.agent.application_code<span style="color:#719e07">=</span>dubbo-provider -Dskywalking.collector.servers<span style="color:#719e07">=</span>localhost:10800 dubbo-provider/target/dubbo-provider.jar |
| </span></span></code></pre></div><h4 id="deploy-the-consumer-service">Deploy the consumer service</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-fallback" data-lang="fallback"><span style="display:flex;"><span>java -jar -javaagent:$AGENT_PATH/skywalking-agent.jar -Dskywalking.agent.application_code=dubbo-consumer -Dskywalking.collector.servers=localhost:10800 dubbo-consumer/target/dubbo-consumer.jar |
| </span></span></code></pre></div><h4 id="visit-demo-service">visit demo service</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>curl http://localhost:8080/sayHello/test |
| </span></span></code></pre></div><h2 id="skywalking-scren-snapshot">Skywalking scren snapshot</h2> |
| <h3 id="dashboard">Dashboard</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/skywalking-dashboard.png" alt="/admin-guide/images/skywalking-dashboard.png"></p> |
| <h3 id="topology">Topology</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/skywalking-topology.png" alt="/admin-guide/images/skywalking-topology.png"></p> |
| <h3 id="application-view">Application view</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/skywalking-application.png" alt="/admin-guide/images/skywalking-application.png"></p> |
| <p>JVM Information |
| <img src="https://dubbo.apache.org/imgs/admin/skywalking-application_instance.png" alt="/admin-guide/images/skywalking-application_instance.png"></p> |
| <h3 id="service-view">Service view</h3> |
| <p>Consumer side |
| <img src="https://dubbo.apache.org/imgs/admin/skywalking-service-consumer.png" alt="/admin-guide/images/skywalking-service-consumer.png"></p> |
| <p>provider side |
| <img src="https://dubbo.apache.org/imgs/admin/skywalking-service-provider.png" alt="/admin-guide/images/skywalking-service-provider.png"></p> |
| <h3 id="trace">Trace</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/skywalking-trace.png" alt="/admin-guide/images/skywalking-trace.png"></p> |
| <p>Span info |
| <img src="https://dubbo.apache.org/imgs/admin/skywalking-span-Info.png" alt="/admin-guide/images/skywalking-span-Info.png"></p> |
| <h3 id="alarm-view">Alarm view</h3> |
| <p><img src="https://dubbo.apache.org/imgs/admin/skywalking-alarm.png" alt="/admin-guide/images/skywalking-alarm.png"></p></description></item></channel></rss> |
