diff --git a/content/influxdb/v1.8/tools/api.md b/content/influxdb/v1.8/tools/api.md
index 8bd41eb8b..879db6da2 100644
--- a/content/influxdb/v1.8/tools/api.md
+++ b/content/influxdb/v1.8/tools/api.md
@@ -146,6 +146,12 @@ Use this endpoint to check the health of your InfluxDB instance.
curl -XGET "localhost:8086/health"
```
+##### /health endpoint responses
+| Response code | Health | Message | Status |
+|:------------- |:------ |:------- | ------:|
+| 200 | Healthy | `ready for queries and writes` | `pass` |
+| 503 | Unhealthy | | `fail` |
+
---
## InfluxDB 1.x HTTP endpoints
diff --git a/content/kapacitor/v1.4/nodes/barrier_node.md b/content/kapacitor/v1.4/nodes/barrier_node.md
index a9ffc3e28..37e8c599c 100644
--- a/content/kapacitor/v1.4/nodes/barrier_node.md
+++ b/content/kapacitor/v1.4/nodes/barrier_node.md
@@ -20,7 +20,7 @@ menu:
| Setters | Description |
|:---|:---|
-| **[idle](#idle) ( `value` `time.Duration`)** | Emit barrier based on idle time since the last received message. Must be greater than zero. |
+| **[idle](#idle) ( `value` `time.Duration`)** | Emit barrier based on idle time since the last received message. Must be greater than zero **and longer than the window `period`**. |
| **[period](#period) ( `value` `time.Duration`)** | Emit barrier based on periodic timer. The timer is based on system clock rather than message time. Must be greater than zero. |
@@ -40,15 +40,16 @@ emitted barrier will be dropped.
Example:
-```javascript
- stream
- |barrier().idle(5s)
- |window()
- .period(10s)
- .every(5s)
- |top(10, 'value')
- //Post the top 10 results over the last 10s updated every 5s.
- |httpPost('http://example.com/api/top10')
+```js
+stream
+ |barrier()
+ .idle(11s) // Must be longer than the window period
+ |window()
+ .period(10s)
+ .every(5s)
+ |top(10, 'value')
+ //Post the top 10 results over the last 10s updated every 5s.
+ |httpPost('http://example.com/api/top10')
```
@@ -66,13 +67,19 @@ Property methods are marked using the `.` operator.
### Idle
Emit barrier based on idle time since the last received message.
-Must be greater than zero.
+Must be greater than zero **and longer than the associated window `period`**.
```javascript
barrier.idle(value time.Duration)
```
+{{% warn %}}
+#### Barrier idle time and window period
+`idle` must be greater than `period` of the associated [window](/kapacitor/v1.4/nodes/window_node/).
+If `idle` times are less than the window `period`, data may be lost.
+{{% /warn %}}
+
diff --git a/content/kapacitor/v1.5/nodes/barrier_node.md b/content/kapacitor/v1.5/nodes/barrier_node.md
index 979d06195..3c69543cb 100644
--- a/content/kapacitor/v1.5/nodes/barrier_node.md
+++ b/content/kapacitor/v1.5/nodes/barrier_node.md
@@ -26,33 +26,34 @@ stream
|from()
.measurement('cpu')
|barrier()
- .idle(5s)
+ .idle(11s) // Must be longer than the window period
.delete(TRUE)
|window()
.period(10s)
.every(5s)
|top(10, 'value')
- //Post the top 10 results over the last 10s updated every 5s.
+ // Post the top 10 results over the last 10s updated every 5s.
|httpPost('http://example.com/api/top10')
```
-> **Note:** In .delete(TRUE), TRUE must be uppercase.
+
+{{% note %}}
+In `.delete(TRUE)`, `TRUE` must be uppercase.
+{{% /note %}}
### Constructor
-| Chaining Method | Description |
-|:---------|:---------|
-| **barrier ( )** | Create a new Barrier node that emits a BarrierMessage periodically |
+| Chaining Method | Description |
+|:--------- |:--------- |
+| **barrier( )** | Create a new Barrier node that emits a BarrierMessage periodically |
### Property Methods
-| Setters | Description |
-|:---|:---|
-| **[idle](#idle) ( `value` `time.Duration`)** | Emit barrier based on idle time since the last received message. Must be greater than zero. |
-| **[period](#period) ( `value` `time.Duration`)** | Emit barrier based on periodic timer. The timer is based on system clock rather than message time. Must be greater than zero. |
-| **[delete](#delete) ( `value` `Boolean`)** | Delete the group after processing each barrier. |
-| **[quiet](#quiet) ( )** | Suppress all error logging events from this node. |
-
-
+| Setters | Description |
+|:--- |:--- |
+| **[idle](#idle) ( `value` `time.Duration`)** | Emit barrier based on idle time since the last received message. Must be greater than zero **and longer than the window `period`**. |
+| **[period](#period) ( `value` `time.Duration`)** | Emit barrier based on periodic timer. The timer is based on system clock rather than message time. Must be greater than zero. |
+| **[delete](#delete) ( `value` `Boolean`)** | Delete the group after processing each barrier. |
+| **[quiet](#quiet) ( )** | Suppress all error logging events from this node. |
### Chaining Methods
[Alert](#alert),
@@ -118,13 +119,19 @@ Property methods are marked using the `.` operator.
### Idle
Emit barrier based on idle time since the last received message.
-Must be greater than zero.
+Must be greater than zero **and longer than the window `period`**.
```js
barrier.idle(value time.Duration)
```
+{{% warn %}}
+#### Barrier idle time and window period
+`idle` must be greater than `period` of the associated [window](/kapacitor/v1.5/nodes/window_node/).
+If `idle` times are less than the window `period`, data may be lost.
+{{% /warn %}}
+