mirror of https://github.com/istio/istio.io.git
Update TCP docs to address issues (#684)
This commit is contained in:
Douglas Reid
GitHub
parent
5ba66d20c0
commit
fc62790e8d
|
|
@ -41,73 +41,73 @@ as the example application throughout this task.
|
|||
Save the following as `tcp_telemetry.yaml`:
|
||||
|
||||
```yaml
|
||||
# Configuration for a metric measuring bytes sent from a server
|
||||
# to a client
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: metric
|
||||
metadata:
|
||||
name: mongosentbytes
|
||||
namespace: default
|
||||
spec:
|
||||
value: connection.sent.bytes | 0 # uses a TCP-specific attribute
|
||||
dimensions:
|
||||
source_service: source.service | "unknown"
|
||||
source_version: source.labels["version"] | "unknown"
|
||||
destination_version: destination.labels["version"] | "unknown"
|
||||
monitoredResourceType: '"UNSPECIFIED"'
|
||||
---
|
||||
# Configuration for a metric measuring bytes sent from a client
|
||||
# to a server
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: metric
|
||||
metadata:
|
||||
name: mongoreceivedbytes
|
||||
namespace: default
|
||||
spec:
|
||||
value: connection.received.bytes | 0 # uses a TCP-specific attribute
|
||||
dimensions:
|
||||
source_service: source.service | "unknown"
|
||||
source_version: source.labels["version"] | "unknown"
|
||||
destination_version: destination.labels["version"] | "unknown"
|
||||
monitoredResourceType: '"UNSPECIFIED"'
|
||||
---
|
||||
# Configuration for a Prometheus handler
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: prometheus
|
||||
metadata:
|
||||
name: mongohandler
|
||||
namespace: default
|
||||
spec:
|
||||
metrics:
|
||||
- name: mongo_sent_bytes # Prometheus metric name
|
||||
instance_name: mongosentbytes.metric.default # Mixer instance name (fully-qualified)
|
||||
kind: COUNTER
|
||||
label_names:
|
||||
- source_service
|
||||
- source_version
|
||||
- destination_version
|
||||
- name: mongo_sent_bytes # Prometheus metric name
|
||||
instance_name: mongosentbytes.metric.default # Mixer instance name (fully-qualified)
|
||||
kind: COUNTER
|
||||
label_names:
|
||||
- source_service
|
||||
- source_version
|
||||
- destination_version
|
||||
---
|
||||
# Rule to send metric instances to a Prometheus handler
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: rule
|
||||
metadata:
|
||||
name: mongoprom
|
||||
namespace: default
|
||||
spec:
|
||||
match: context.protocol == "tcp"
|
||||
&& destination.service = "mongodb.default.svc.cluster.local"
|
||||
actions:
|
||||
- handler: mongohandler.prometheus
|
||||
instances:
|
||||
- mongoreceivedbytes.metric
|
||||
- mongosentbytes.metric
|
||||
# Configuration for a metric measuring bytes sent from a server
|
||||
# to a client
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: metric
|
||||
metadata:
|
||||
name: mongosentbytes
|
||||
namespace: default
|
||||
spec:
|
||||
value: connection.sent.bytes | 0 # uses a TCP-specific attribute
|
||||
dimensions:
|
||||
source_service: source.service | "unknown"
|
||||
source_version: source.labels["version"] | "unknown"
|
||||
destination_version: destination.labels["version"] | "unknown"
|
||||
monitoredResourceType: '"UNSPECIFIED"'
|
||||
---
|
||||
# Configuration for a metric measuring bytes sent from a client
|
||||
# to a server
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: metric
|
||||
metadata:
|
||||
name: mongoreceivedbytes
|
||||
namespace: default
|
||||
spec:
|
||||
value: connection.received.bytes | 0 # uses a TCP-specific attribute
|
||||
dimensions:
|
||||
source_service: source.service | "unknown"
|
||||
source_version: source.labels["version"] | "unknown"
|
||||
destination_version: destination.labels["version"] | "unknown"
|
||||
monitoredResourceType: '"UNSPECIFIED"'
|
||||
---
|
||||
# Configuration for a Prometheus handler
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: prometheus
|
||||
metadata:
|
||||
name: mongohandler
|
||||
namespace: default
|
||||
spec:
|
||||
metrics:
|
||||
- name: mongo_sent_bytes # Prometheus metric name
|
||||
instance_name: mongosentbytes.metric.default # Mixer instance name (fully-qualified)
|
||||
kind: COUNTER
|
||||
label_names:
|
||||
- source_service
|
||||
- source_version
|
||||
- destination_version
|
||||
- name: mongo_received_bytes # Prometheus metric name
|
||||
instance_name: mongoreceivedbytes.metric.default # Mixer instance name (fully-qualified)
|
||||
kind: COUNTER
|
||||
label_names:
|
||||
- source_service
|
||||
- source_version
|
||||
- destination_version
|
||||
---
|
||||
# Rule to send metric instances to a Prometheus handler
|
||||
apiVersion: "config.istio.io/v1alpha2"
|
||||
kind: rule
|
||||
metadata:
|
||||
name: mongoprom
|
||||
namespace: default
|
||||
spec:
|
||||
match: context.protocol == "tcp"
|
||||
&& destination.service == "mongodb.default.svc.cluster.local"
|
||||
actions:
|
||||
- handler: mongohandler.prometheus
|
||||
instances:
|
||||
- mongoreceivedbytes.metric
|
||||
- mongosentbytes.metric
|
||||
```
|
||||
|
||||
1. Push the new configuration.
|
||||
|
|
@ -126,7 +126,16 @@ as the example application throughout this task.
|
|||
|
||||
1. Setup BookInfo to use MongoDB.
|
||||
|
||||
1. Install `v2` of the `ratings` service:
|
||||
1. Install `v2` of the `ratings` service.
|
||||
|
||||
If you are using a cluster with automatic sidecar injection enabled,
|
||||
simply deploy the services using `kubectl`:
|
||||
|
||||
```
|
||||
kubectl apply -f samples/bookinfo/kube/bookinfo-ratings-v2.yaml
|
||||
```
|
||||
|
||||
If you are using manual sidecar injection, use the following command instead:
|
||||
|
||||
```
|
||||
kubectl apply -f <(istioctl kube-inject -f samples/bookinfo/kube/bookinfo-ratings-v2.yaml)
|
||||
|
|
@ -140,6 +149,15 @@ as the example application throughout this task.
|
|||
|
||||
1. Install the `mongodb` service:
|
||||
|
||||
If you are using a cluster with automatic sidecar injection enabled,
|
||||
simply deploy the services using `kubectl`:
|
||||
|
||||
```
|
||||
kubectl apply -f samples/bookinfo/kube/bookinfo-db.yaml
|
||||
```
|
||||
|
||||
If you are using manual sidecar injection, use the following command instead:
|
||||
|
||||
```
|
||||
kubectl apply -f <(istioctl kube-inject -f samples/bookinfo/kube/bookinfo-db.yaml)
|
||||
```
|
||||
|
|
@ -154,14 +172,14 @@ as the example application throughout this task.
|
|||
1. Add routing rules to send traffic to `v2` of the `ratings` service:
|
||||
|
||||
```
|
||||
kubectl apply -f samples/bookinfo/kube/route-rule-ratings-db.yaml
|
||||
istioctl create -f samples/bookinfo/kube/route-rule-ratings-db.yaml
|
||||
```
|
||||
|
||||
Expected output:
|
||||
|
||||
```
|
||||
routerule "ratings-test-v2" created
|
||||
routerule "reviews-test-ratings-v2" created
|
||||
Created config route-rule//ratings-test-v2 at revision 7216403
|
||||
Created config route-rule//reviews-test-ratings-v2 at revision 7216404
|
||||
```
|
||||
|
||||
1. Send traffic to the sample application.
|
||||
|
|
@ -232,6 +250,12 @@ protocols within policies.
|
|||
istioctl delete -f tcp_telemetry.yaml
|
||||
```
|
||||
|
||||
* Remove the `port-forward` process:
|
||||
|
||||
```bash
|
||||
killall kubectl
|
||||
```
|
||||
|
||||
* If you are not planning to explore any follow-on tasks, refer to the
|
||||
[BookInfo cleanup]({{home}}/docs/guides/bookinfo.html#cleanup) instructions
|
||||
to shutdown the application.
|
||||
|
|
|
|||
Loading…
Reference in New Issue