diff --git a/README.md b/README.md
index 44aa95f..b1dfb80 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,9 @@ SOFALookout 是一个利用多维度的 metrics 对目标系统进行度量和
 
 - 客户端代码编译，进入client子目录，Maven 3.2.5+, JDK Version 1.6+；
 - 服务器端代码编译，进入server子目录，Maven 3.2.5+, JDK Version 1.8+；
+## 样例工程
+
+样例工程演示了如何快速使用 SOFALookout，[详细可参考](https://github.com/alipay/sofa-lookout/wiki/useguide-samples)。
 
 ## 贡献
 如何参与 SOFALookout [代码贡献](./CONTRIBUTING.md)
diff --git a/client/samples/lookout-client-samples-boot/README.md b/client/samples/lookout-client-samples-boot/README.md
index 7b2881c..9260487 100644
--- a/client/samples/lookout-client-samples-boot/README.md
+++ b/client/samples/lookout-client-samples-boot/README.md
@@ -1,5 +1,22 @@
-启动后访问：http://localhost:8080/metrics
+## 这里演示与 SpringBoot Actuator 集成
+
+- 添加依赖
+
+```
+<dependency>
+    <groupId>com.alipay.sofa.lookout</groupId>
+    <artifactId>lookout-reg-dropwizard</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.dropwizard.metrics</groupId>
+    <artifactId>metrics-core</artifactId>
+</dependency>
+```
+
+- 启动后访问：http://localhost:8080/metrics
 
 ```
+...
 http_requests_total.instant-luyideMacBook-Pro.local: 1,
+...
 ```
\ No newline at end of file
diff --git a/client/samples/lookout-client-samples-java/README.md b/client/samples/lookout-client-samples-java/README.md
index bb76417..9d1a154 100644
--- a/client/samples/lookout-client-samples-java/README.md
+++ b/client/samples/lookout-client-samples-java/README.md
@@ -1 +1,7 @@
-start it, and wait for 2 minutes at least.
\ No newline at end of file
+Start it, and wait for 2 minutes at least.
+
+Wait the following logs on the console:
+
+```
+==> [{"time":"2018-06-05T16:41:00+08:00","tags":{"app":"appName","ip":"10.15...
+```
\ No newline at end of file
diff --git a/client/samples/lookout-client-samples-prometheus/README.md b/client/samples/lookout-client-samples-prometheus/README.md
index 4190113..d6d6f28 100644
--- a/client/samples/lookout-client-samples-prometheus/README.md
+++ b/client/samples/lookout-client-samples-prometheus/README.md
@@ -12,7 +12,10 @@
             <version>${lookout.client.version}</version>
         </dependency>
 ```
-## 2.启动samples,后可以访问：http://localhost:{com.alipay.sofa.lookout.prometheus.exporter.server.port}
+
+## 2.启动samples,后可以访问：http://localhost:9494
+
+端口可以改变，配置项：`com.alipay.sofa.lookout.prometheus-exporter-server-port`
 
 ## 3.可以配合 prometheus 服务查看