未验证 提交 70b1ec69 编写于 作者: W Wing 提交者: GitHub

Refine README.md (#7649)

上级 0fae36ed
# UI Introduction # Introduction to UI
SkyWalking official UI provides the default and powerful visualization capabilities for SkyWalking observing distributed The SkyWalking official UI provides the default and powerful visualization capabilities for SkyWalking to observe distributed
cluster. clusters.
The latest introduction video could be found on the Youtube Watch the latest introduction video on Youtube:
[![RocketBot UI](https://img.youtube.com/vi/mfKaToAKl7k/0.jpg)](http://www.youtube.com/watch?v=mfKaToAKl7k) [![RocketBot UI](https://img.youtube.com/vi/mfKaToAKl7k/0.jpg)](http://www.youtube.com/watch?v=mfKaToAKl7k)
SkyWalking dashboard includes the following part. The SkyWalking dashboard includes these parts:
<img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard.png"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard.png"/>
1. **Feature Tab Selector Zone**. The key features are list there. The more details will be introduced below. 1. **Feature Tab Selector Zone**. The key features are listed there. More details will be introduced below.
1. **Reload Zone**. Control the reload mechanism, including reload periodically or manually. 1. **Reload Zone**. It controls the reload mechanism, including the option to reload periodically or manually.
1. **Time Selector Zone**. Control the timezone and time range. And a Chinese/English switch button here, default, the UI 1. **Time Selector Zone**. It controls the timezone and time range, and comes with a Chinese/English language switch button. By default, the UI
uses the browser language setting. We also welcome to contribute more languages. uses the language setting of the browser. We also welcome translation contributions to extend our reach into more languages.
## Dashboard ## Dashboard
Dashboard provide metrics of service, service instance and endpoint. There are a few metrics terms you need to understand The dashboard provides metrics of services, service instances, and endpoints. Here's a quick terminology guide on metrics:
* Throughput CPM , represents calls per minute. * **Throughput CPM**: Represents calls per minute.
* Apdex score, Read [Apdex in WIKI](https://en.wikipedia.org/wiki/Apdex) * **Apdex score**: See [Apdex on Wiki](https://en.wikipedia.org/wiki/Apdex).
* Response Time Percentile, including `p99`, `p95`, `p90`, `p75`, `p50`. Read [percentile in WIKI](https://en.wikipedia.org/wiki/Percentile) * **Response Time Percentile**: Includes `p99`, `p95`, `p90`, `p75`, and `p50`. See [percentile on Wiki](https://en.wikipedia.org/wiki/Percentile).
* SLA, represents the successful rate. For HTTP, it means the rate of 200 response code. * **SLA**: Represents the success rate. For HTTP, the response status code is default to 200.
Service, Instance and Dashboard selector could reload manually rather than reload the whole page. NOTICE, the **Reload Zone** The Service, Instance and Dashboard selectors can be reloaded manually, so it's not necessary to always reload the whole page. Note that the **Reload Zone** does not reload these selectors.
wouldn't reload these selectors.
<img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard-reload.png"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard-reload.png"/>
...@@ -31,13 +30,12 @@ Two default dashboards are provided to visualize the metrics of service and data ...@@ -31,13 +30,12 @@ Two default dashboards are provided to visualize the metrics of service and data
<img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard-default.png"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/dashboard-default.png"/>
User could click the `lock` button left aside the `Service/Instance/Endpoint Reload` button to custom your own dashboard. Click the `Lock` button on the left of the `Service/Instance/Endpoint Reload` button to customize your dashboard.
### Custom Dashboard ### Custom Dashboard
Users could customize the dashboard. The default dashboards are provided through the default templates located in Users may customize their dashboards. The default dashboards are provided in the default templates located in the `/ui-initialized-templates` folders.
`/ui-initialized-templates` folders.
The template file must end with `.yml` or `.yaml` and follows this format. The template file must end with `.yml` or `.yaml`. It follows this format:
```yaml ```yaml
templates: templates:
- name: template name # The unique name - name: template name # The unique name
...@@ -81,73 +79,68 @@ templates: ...@@ -81,73 +79,68 @@ templates:
disabled: false disabled: false
``` ```
**NOTE**, UI initialized templates would only be initialized if there is no template in the storage has the same name. **NOTE**: UI initialized templates would only be initialized if no template in the storage has the same name.
Check the entity named as `ui_template` in your storage. Check the entity named `ui_template` in your storage.
## Topology ## Topology
Topology map shows the relationship among the services and instances with metrics. A topology map shows the relationship between services and instances with metrics.
<img src="https://skywalking.apache.org/ui-doc/8.4.0/topology.png"/> <img src="https://skywalking.apache.org/ui-doc/8.4.0/topology.png"/>
* Topology shows the default global topology including all services. Global topology is shown by default, which means that all services are included.
* **Service Selector** provides 2 level selectors, service group list and service name list. The group name is separated from * **Service Selector** provides two-level selectors, service group lists, and service name lists. The group name is separated from
the service name if it follows `<group name>::<logic name>` format. Topology map is available for single group, single service, the service name if it follows the `<group name>::<logic name>` format. Topology maps are available for single group, single service,
or global(include all services). or global (where all services are included).
* **Custom Group** provides the any sub topology capability of service group. * **Custom Group** allows you to create sub-topologies for a service group.
* **Service Deep Dive** opens when you click any service. The honeycomb could do metrics, trace and alarm query of the selected service. * **Service Deep Dive** opens when you click on any service. The honeycomb could carry out metrics, trace, and alarm query of the selected service.
* **Service Relationship Metrics** gives the metrics of service RPC interactions and instances of these two services. * **Service Relationship Metrics** provides the metrics of service RPC interactions and the instances of these two services.
## Trace Query ## Trace Query
Trace query is a typical feature as SkyWalking provided distributed agents. Since SkyWalking provides distributed agents, trace query is a key feature.
<img src="https://skywalking.apache.org/ui-doc/7.0.0/trace.png"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/trace.png"/>
* **Trace Segment List** is not the trace list. Every trace has several segments belonging to different services. If * **Trace Segment List** is not the same as a trace list. Every trace has several segments belonging to different services. If you start a query by all services or by trace IDs, different segments with the same trace ID may be listed there.
query by all services or by trace id, different segments with same trace id could be list there. * **Span** can be clicked. The details of each span will pop up on the left.
* **Span** is clickable, the detail of each span will pop up on the left side. * **Trace Views** provides three typical and different usage views to visualize the trace.
* **Trace Views** provides 3 typical and different usage views to visualize the trace.
## Profile ## Profile
Profile is an interaction feature. It provides the method level performance diagnosis. Profile is an interactive feature. It provides method-level performance diagnoses.
To start the profile analysis, user need to create the profile task To start profile analysis, you need to create a profile task:
<img src="https://skywalking.apache.org/ui-doc/7.0.0/profile-create.png" width="440px"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/profile-create.png" width="440px"/>
1. Select the specific service. 1. Select the specific service.
1. Set the endpoint name. This endpoint name typically is the operation name of the first span. Find this on the trace 1. Set the Endpoint Name. This endpoint name is typically the operation name of the first span. Find this on the trace
segment list view. segment list view.
1. Monitor time could start right now or from any given future time. 1. Monitor Time could start right now or from any given future time.
1. Monitor duration defines the observation time window to find the suitable request to do performance analysis. 1. Monitor Duration defines the observation time window to find the suitable request to conduct performance analysis.
Even the profile add a very limited performance impact to the target system, but it is still an additional load. This duration Even though the profile has a very limited performance impact on the target system, it still amounts to an additional load. Setting this duration allows you to control the impact.
make the impact controllable. 1. Min Duration Threshold provides a filter mechanism. If a request of the given endpoint responds quickly, it will not be profiled. This ensures that the profiled data is the expected one.
1. Min duration threshold provides a filter mechanism, if a request of the given endpoint response quickly, it wouldn't be 1. Max Sampling Count gives the maximum dataset to be collected by the agent. It helps reduce memory and network load.
profiled. This could make sure, the profiled data is the expected one. 1. An implicit condition is that **at any moment, SkyWalking only accepts one profile task for each service**.
1. Max sampling count gives the max dataset of agent will collect. It helps to reduce the memory and network load. 1. Individual agents may have different settings to control or limit this feature. Read document setup for more details.
1. One implicit condition, **in any moment, SkyWalking only accept one profile task for each service**. 1. Not all SkyWalking ecosystem agents support this feature. Java agent from version 7.0.0 supports this by default.
1. Agent could have different settings to control or limit this feature, read document setup for more details.
1. Not all SkyWalking ecosystem agent supports this feature, java agent from 7.0.0 supports this in default. Once the profile is done, the profiled trace segments would show up, and you could request to analyze any span.
Typically, we analyze spans with long duration. If a span and its children both have long duration, you could set the analysis boundaries by choosing to `Include Children` or `Exclude Children`.
Once the profile done, the profiled trace segments would show up. And you could request for analysis for any span.
Typically, we analysis spans having long self duration, if the span and its children both have long duration, you could choose Choose the appropriate span, and click `Analyze`. You will see the stack-based analysis results. The slowest methods are highlighted.
`include children` or `exclude childrend` to set the analysis boundaries.
After choose the right span, and click the `analysis` button, you will see the stack based analysis result. The slowest methods
have been highlighted.
<img src="https://skywalking.apache.org/ui-doc/7.0.0/profile-result.png"/> <img src="https://skywalking.apache.org/ui-doc/7.0.0/profile-result.png"/>
### Advanced features ### Advanced features
1. Since 7.1.0, the profiled trace collects the HTTP request parameters for Tomcat and SpringMVC Controller automatically. 1. Since version 7.1.0, the profiled trace automatically collects the HTTP request parameters for Tomcat and SpringMVC Controller.
## Log ## Log
Since 8.3.0, SkyWalking provides log query for the browser monitoring. Use [Apache SkyWalking Client JS](https://github.com/apache/skywalking-client-js) Since version 8.3.0, SkyWalking has provided log query for browser monitoring. Use [Apache SkyWalking Client JS](https://github.com/apache/skywalking-client-js) agent to collect metrics and error logs.
agent would collect metrics and error logs.
Since 8.5.0, SkyWalking supports collecting logs through our native agents and 3rd party agents(such as Fluentd, Filebeat). Since version 8.5.0, SkyWalking supports collecting logs through its native agents and third party agents (such as Fluentd and Filebeat).
Read [Log Analyzer Document](../setup/backend/log-analyzer.md) for more details. See [Log Analyzer Document](../setup/backend/log-analyzer.md) for more details.
<img src="https://skywalking.apache.org/ui-doc/8.3.0/log.png"/> <img src="https://skywalking.apache.org/ui-doc/8.3.0/log.png"/>
## Alarm ## Alarm
Alarm page lists all triggered alarm. Read the backend setup documentation to know how to set up the alarm rule or integrate The alarm page lists all triggered alarms. See backend setup documentation to learn how to set up alarm rules or integrate
with 3rd party system. with third party systems.
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册