mirror of https://github.com/istio/istio.io.git
[uk] Cherrypick latest updates in 1.24 for Ukrainian translation (#16025)
* sync fixes for 1.24 with upstream * [uk] Re PR #15965 * [uk] Re PR #15970 * [uk] Re PR #15971 * [uk] Re PR #15990 * [uk] Re PR #15997 * [uk] Re PR #16007
This commit is contained in:
Andrii Holovin
GitHub
parent
416f939b45
commit
e652c99081
|
|
@ -1,18 +0,0 @@
|
|||
---
|
||||
title: Як вимкнути трейсинг?
|
||||
weight: 50
|
||||
---
|
||||
|
||||
Якщо ви вже встановили Istio з увімкненим трейсингом, ви можете вимкнути його наступним чином:
|
||||
|
||||
{{< text plain >}}
|
||||
# Заповніть <istio namespace> простором імен вашої mesh Istio. Наприклад: istio-system
|
||||
TRACING_POD=`kubectl get po -n <istio namespace> | grep istio-tracing | awk '{print $1}'`
|
||||
$ kubectl delete pod $TRACING_POD -n <istio namespace>
|
||||
$ kubectl delete services tracing zipkin -n <istio namespace>
|
||||
# Тепер вручну видаліть всі екземпляри trace_zipkin_url з файлу та збережіть його.
|
||||
{{< /text >}}
|
||||
|
||||
Потім дотримуйтесь кроків [розділу очищення завдання Розподілений трейсинг](/docs/tasks/observability/distributed-tracing/zipkin/#cleanup).
|
||||
|
||||
Якщо вам взагалі не потрібна функціональність трейсинг, тоді [вимкніть трейсинг](/docs/tasks/observability/distributed-tracing/zipkin/#before-you-begin) під час встановлення Istio.
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
---
|
||||
title: Чи може Istio відправляти інформацію про трейсинг на зовнішній сервер сумісний з Zipkin?
|
||||
weight: 70
|
||||
---
|
||||
|
||||
Так, для цього потрібно використовувати повне доменне імʼя сумісного з Zipkin екземпляру. Наприклад: `zipkin.mynamespace.svc.cluster.local`.
|
||||
|
|
@ -5,4 +5,4 @@ weight: 0
|
|||
|
||||
Istio інтегрується з системами розподіленого трейсингу, використовуючи [Envoy-based](#how-envoy-based-tracing-works) трейсинг. Завдяки інтеграції трейсингу на основі Envoy, [застосунки відповідають за перенаправлення заголовків трейсів](#istio-copy-headers) для наступних вихідних запитів.
|
||||
|
||||
Додаткову інформацію можна знайти в завданнях Розподілений трейсинг в Istio ([Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/), [Lightstep](/docs/tasks/observability/distributed-tracing/lightstep/), [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/)) та у [документації Envoy щодо трейсів](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/tracing).
|
||||
Додаткову інформацію можна знайти в [огляді Розподіленого трейсингу](/docs/tasks/observability/distributed-tracing/overview/) та у [документації Envoy щодо трейсів](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/observability/tracing).
|
||||
|
|
|
|||
|
|
@ -12,4 +12,4 @@ Envoy:
|
|||
- надсилає згенеровані трейс-відрізки (span) до бекендів трейсингу
|
||||
- передає заголовки трейсингу до застосунку, який проходить через проксі
|
||||
|
||||
Istio підтримує інтеграції трейсингу на основі Envoy для [Lightstep](/docs/tasks/observability/distributed-tracing/lightstep/) та [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/), а також усіх сумісних з API Zipkin бекендів, включаючи [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/).
|
||||
Istio підтримує [OpenTelemetry](/docs/tasks/observability/distributed-tracing/opentelemetry/) та сумісні бекенди включаючи [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/). Серед інших платформ також підтримуються [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/) та [Apache SkyWalking](/docs/tasks/observability/distributed-tracing/skywalking/).
|
||||
|
|
|
|||
|
|
@ -5,9 +5,14 @@ weight: 10
|
|||
|
||||
Istio дозволяє звітувати про трейс-відрізки (span) для комунікацій між робочими навантаженнями всередині мережі. Проте, щоб різні трейс-відрізки (span) могли бути зшиті разом для повного огляду потоку трафіку, застосунки повинні пропагувати контекст трейсингу між вхідними та вихідними запитами.
|
||||
|
||||
Зокрема, Istio покладається на застосунки для [пропагування заголовків B3 трейсингу](https://github.com/openzipkin/b3-propagation), а також згенерованого Envoy ID запиту. Ці заголовки включають:
|
||||
Зокрема, Istio покладається на застосунки для пересилання ідентифікатора запиту, згенерованого Envoy, і стандартних заголовків. Ці заголовки включають
|
||||
|
||||
- `x-request-id`
|
||||
- `traceparent`
|
||||
- `tracestate`
|
||||
|
||||
Користувачі Zipkin повинні переконатися, що вони [поширюють заголовки трейсів B3] (https://github.com/openzipkin/b3-propagation).
|
||||
|
||||
- `x-b3-traceid`
|
||||
- `x-b3-spanid`
|
||||
- `x-b3-parentspanid`
|
||||
|
|
@ -15,13 +20,4 @@ Istio дозволяє звітувати про трейс-відрізки (sp
|
|||
- `x-b3-flags`
|
||||
- `b3`
|
||||
|
||||
Якщо ви використовуєте Lightstep, вам також потрібно буде передавати наступні заголовки:
|
||||
|
||||
- `x-ot-span-context`
|
||||
|
||||
Якщо ви використовуєте OpenTelemetry або Stackdriver, вам також потрібно буде передавати наступні заголовки:
|
||||
|
||||
- `traceparent`
|
||||
- `tracestate`
|
||||
|
||||
Пропагування заголовків може бути здійснене за допомогою бібліотек клієнтів, таких як [Zipkin](https://zipkin.io/pages/tracers_instrumentation.html) або [Jaeger](https://github.com/jaegertracing/jaeger-client-java/tree/master/jaeger-core#b3-propagation). Також це можна зробити вручну, як документовано в [Завданні з трейсингу](/docs/tasks/observability/distributed-tracing/overview/#trace-context-propagation).
|
||||
Розповсюдження заголовків можна виконати за допомогою клієнтських бібліотек, таких як [OpenTelemetry](https://opentelemetry.io/docs/concepts/context-propagation/). Це також можна зробити вручну, як задокументовано у [Задачі розподіленого трасування](/docs/tasks/observability/distributed-tracing/overview/#trace-context-propagation).
|
||||
|
|
|
|||
|
|
@ -0,0 +1,6 @@
|
|||
---
|
||||
title: Хто генерує початкові заголовки трейсів?
|
||||
weight: 15
|
||||
---
|
||||
|
||||
Шлюз Istio або додатковий проксі-сервер (Envoy) генерує початкові [заголовки](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#x-request-id), якщо вони не вказані в запиті.
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
---
|
||||
title: Хто генерує початкові HTTP заголовки Zipkin (B3)?
|
||||
weight: 15
|
||||
---
|
||||
|
||||
Початкові [заголовки](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_conn_man/headers#x-request-id) Zipkin (B3) генерує sidecar проксі Istio (Envoy), якщо вони не надаються запитом.
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
---
|
||||
title: Яка мінімальна конфігурація Istio потрібна для розподіленого трейсингу?
|
||||
weight: 13
|
||||
---
|
||||
|
||||
Для інтеграції з бекендами, сумісними з Zipkin, достатньо встановити [мінімальний профіль Istio](/docs/setup/install/helm/) з увімкненим трейсингом.
|
||||
|
|
@ -3,8 +3,8 @@ title: Чому мої запити не відстежуються?
|
|||
weight: 30
|
||||
---
|
||||
|
||||
З початку версії Istio 1.0.3 швидкість вибірки для трейсингу була зменшена до 1% в [конфігураційному профілі `default`](/docs/setup/additional-setup/config-profiles/). Це означає, що лише 1 з 100 трейсів, захоплених Istio, буде надіслано до бекенда для трейсингу. Швидкість вибірки в профілі `demo` все ще встановлена на 100%. Дивіться [цей розділ секцію](/docs/tasks/observability/distributed-tracing/mesh-and-proxy-config/#customizing-trace-sampling) для отримання додаткової інформації про те, як налаштувати швидкість вибірки.
|
||||
Швидкість вибірки для трейсингу встановлена в 1% в [конфігураційному профілі `default`](/docs/setup/additional-setup/config-profiles/). Це означає, що лише 1 зі 100 трейсів, захоплених Istio, буде надіслано до бекенда для трейсингу. Швидкість вибірки в профілі `demo` все ще встановлена на 100%. Дивіться [цей розділ секцію](/docs/tasks/observability/distributed-tracing/telemetry-api/#customizing-trace-sampling) для отримання додаткової інформації про те, як налаштувати швидкість вибірки.
|
||||
|
||||
Якщо ви все ще не бачите дані трейсингу, будь ласка, переконайтесь, що ваші порти відповідають [конвенціям іменування портів](/about/faq/#naming-port-convention) в Istio і що відповідний порт контейнера відкритий (наприклад, через специфікацію podʼа), щоб дозволити захоплення трафіку sidecar проксі (Envoy).
|
||||
|
||||
Якщо ви бачите дані трейсингу тільки для egress-проксі, але не для ingress-проксі, це також може бути повʼязано з [конвенціями іменування портів](/about/faq/#naming-port-convention). Починаючи з [Istio 1.3](/news/releases/1.3.x/announcing-1.3/#intelligent-protocol-detection-experimental), протокол для **вихідного** трафіку визначається автоматично.
|
||||
Якщо ви бачите дані трейсингу тільки для egress-проксі, але не для ingress-проксі, це також може бути повʼязано з [конвенціями іменування портів](/about/faq/#naming-port-convention).
|
||||
|
|
|
|||
|
|
@ -1,14 +1,13 @@
|
|||
---
|
||||
---
|
||||
* Створіть простір імен для OpenTelemetry Collector:
|
||||
Створіть простір імен для OpenTelemetry Collector:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl create namespace observability
|
||||
{{< /text >}}
|
||||
{{< text bash >}}
|
||||
$ kubectl create namespace observability
|
||||
{{< /text >}}
|
||||
|
||||
* Розгорніть OpenTelemetry Collector. Ви можете використовувати цей приклад конфігурації як відправну точку:
|
||||
[`otel.yaml`]({{< github_blob >}}/samples/open-telemetry/otel.yaml)
|
||||
Розгорніть OpenTelemetry Collector. Ви можете використовувати цей [приклад конфігурації]({{< github_blob >}}/samples/open-telemetry/otel.yaml) як відправну точку.
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n observability
|
||||
{{< /text >}}
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f @samples/open-telemetry/otel.yaml@ -n observability
|
||||
{{< /text >}}
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ test: no
|
|||
На малюнку показано загальний вигляд компонентів панелі управління та потоків між проксі ztunnel і панеллю управління `istiod`.
|
||||
|
||||
{{< image width="100%"
|
||||
link="ztunnel-architecture.png"
|
||||
link="ztunnel-architecture.svg"
|
||||
caption="Архітектура Ztunnel"
|
||||
>}}
|
||||
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 355 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 37 KiB |
|
|
@ -28,8 +28,8 @@ $ export PATH=$PWD/bin:$PATH
|
|||
|
||||
{{< text syntax=bash snip_id=none >}}
|
||||
$ istioctl version
|
||||
no ready Istio pods in "istio-system"
|
||||
{{< istio_full_version >}}
|
||||
Istio is not present in the cluster: no running Istio pods in namespace "istio-system"
|
||||
client version: {{< istio_full_version >}}
|
||||
{{< /text >}}
|
||||
|
||||
## Встановлення Istio у ваш кластер {#install-istio-on-to-your-cluster}
|
||||
|
|
@ -40,7 +40,7 @@ no ready Istio pods in "istio-system"
|
|||
$ istioctl install --set profile=ambient --skip-confirmation
|
||||
{{< /text >}}
|
||||
|
||||
Може знадобитися кілька хвилин, щоб компоненти Istio були встановлені. Як тільки установка буде завершена, ви отримаєте наступний результат, який вказує на те, що всі компоненти були успішно встановлені.
|
||||
Як тільки установку буде завершено, ви отримаєте наступний результат, який вказує на те, що всі компоненти були успішно встановлені.
|
||||
|
||||
{{< text syntax=plain snip_id=none >}}
|
||||
✔ Istio core installed
|
||||
|
|
@ -50,16 +50,12 @@ $ istioctl install --set profile=ambient --skip-confirmation
|
|||
✔ Installation complete
|
||||
{{< /text >}}
|
||||
|
||||
{{< tip >}}
|
||||
Ви можете перевірити встановлені компоненти за допомогою команди `istioctl verify-install`.
|
||||
{{< /tip >}}
|
||||
|
||||
## Встановлення CRD для Kubernetes Gateway API {#install-the-kubernetes-gateway-api-crds}
|
||||
|
||||
{{< boilerplate gateway-api-install-crds >}}
|
||||
|
||||
Ви використовуватимете Kubernetes Gateway API для налаштування маршрутизації трафіку.
|
||||
|
||||
{{< boilerplate gateway-api-install-crds >}}
|
||||
|
||||
## Подальші кроки {#next-steps}
|
||||
|
||||
Вітаємо! Ви успішно встановили Istio з підтримкою режиму оточення. Перейдіть до наступного кроку, щоб [встановити демонстраційний застосунок і додати його до сервісної мережі в режимі оточення](/docs/ambient/getting-started/deploy-sample-app/).
|
||||
Вітаємо! Ви успішно встановили Istio з підтримкою режиму оточення. Перейдіть до наступного кроку, щоб [встановити демонстраційний застосунок](/docs/ambient/getting-started/deploy-sample-app/).
|
||||
|
|
|
|||
|
|
@ -8,40 +8,45 @@ test: yes
|
|||
|
||||
Якщо вам більше не потрібні Istio та повʼязані ресурси, ви можете видалити їх, дотримуючись цих кроків.
|
||||
|
||||
## Видалення міток ambient і waypoint {#remove-ambient-waypoint-labels}
|
||||
|
||||
Мітка, що інструктує Istio автоматично включати застосунки в просторі `default` в ambient mesh, стандартно не видаляється. Якщо вона більше не потрібна, використовуйте наступну команду для її видалення:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl label namespace default istio.io/dataplane-mode-
|
||||
$ kubectl label namespace default istio.io/use-waypoint-
|
||||
{{< /text >}}
|
||||
|
||||
## Видалення проксі waypoint {#remove-waypoint-proxies}
|
||||
|
||||
Щоб видалити проксі waypoint, встановлені політики та деінсталювати Istio, виконайте наступні команди:
|
||||
Щоб видалити всі проксі waypoint виконайте наступні команди:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl label namespace default istio.io/use-waypoint-
|
||||
$ istioctl waypoint delete --all
|
||||
{{< /text >}}
|
||||
|
||||
## Видалення Istio {#uninstall-istio}
|
||||
## Видалення простору імен з панелі даних ambient {#remove-the-namespace-from-the-ambient-data-plane}
|
||||
|
||||
Щоб видалити Istio:
|
||||
Мітка, що інструктує Istio автоматично включати застосунки в просторі `default` в ambient mesh, стандартно не видаляється Istio. Використовуйте наступну команду для її видалення:
|
||||
|
||||
{{< text syntax=bash snip_id=none >}}
|
||||
$ istioctl uninstall -y --purge
|
||||
$ kubectl delete namespace istio-system
|
||||
{{< text bash >}}
|
||||
$ kubectl label namespace default istio.io/dataplane-mode-
|
||||
{{< /text >}}
|
||||
|
||||
Ви маєте видалити всі робочі навантаження з панелі даних ambient перед видаленням Istio.
|
||||
|
||||
## Видалення демонстраційного застосунку {#remove-the-sample-application}
|
||||
|
||||
Щоб видалити демонстраційний застосунок Bookinfo та deployment `curl`, виконайте наступне:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl delete httproute reviews
|
||||
$ kubectl delete authorizationpolicy productpage-viewer
|
||||
$ kubectl delete -f samples/curl/curl.yaml
|
||||
$ kubectl delete -f samples/bookinfo/platform/kube/bookinfo.yaml
|
||||
$ kubectl delete -f samples/bookinfo/platform/kube/bookinfo-versions.yaml
|
||||
$ kubectl delete -f samples/curl/curl.yaml
|
||||
$ kubectl delete -f samples/bookinfo/gateway-api/bookinfo-gateway.yaml
|
||||
{{< /text >}}
|
||||
|
||||
## Видалення Istio {#uninstall-istio}
|
||||
|
||||
Щоб видалити Istio з вашого кластера:
|
||||
|
||||
{{< text syntax=bash snip_id=none >}}
|
||||
$ istioctl uninstall -y --purge
|
||||
$ kubectl delete namespace istio-system
|
||||
{{< /text >}}
|
||||
|
||||
## Видалення CRD для Kubernetes Gateway API {#remove-gateway-api-crds}
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Розгортання застосунку
|
||||
description: РОзротання демонстраційного застосунку Bookinfo.
|
||||
title: Розгортання демонстраційного застосунку
|
||||
description: Розротання демонстраційного застосунку Bookinfo.
|
||||
weight: 2
|
||||
owner: istio/wg-networking-maintainers
|
||||
test: yes
|
||||
|
|
@ -58,6 +58,8 @@ NAME CLASS ADDRESS PR
|
|||
bookinfo-gateway istio bookinfo-gateway-istio.default.svc.cluster.local True 42s
|
||||
{{< /text >}}
|
||||
|
||||
Зачекайте, поки шлюз не зʼявиться, як запрограмовано, перш ніж продовжити.
|
||||
|
||||
## Доступ до застосунку {#access-the-application}
|
||||
|
||||
Ви зможете зʼєднатись з сервісом Bookinfo `productpage` через шлюз, який ви щойно налаштували. Щоб отримати доступ до шлюзу, використовуйте команду `kubectl port-forward`:
|
||||
|
|
@ -70,7 +72,7 @@ $ kubectl port-forward svc/bookinfo-gateway-istio 8080:80
|
|||
|
||||
{{< image width="80%" link="./bookinfo-browser.png" caption="Застосунок Bookinfo" >}}
|
||||
|
||||
Якщо ви оновите сторінку, ви повинні побачити, як відгуки та рейтинги книг змінюються, оскільки запити розподіляються між різними версіями сервісу `reviews`.
|
||||
Якщо ви оновите сторінку, ви повинні побачити, як рейтинги книг змінюються, оскільки запити розподіляються між різними версіями сервісу `reviews`.
|
||||
|
||||
## Подальші кроки {#next-steps}
|
||||
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ test: yes
|
|||
|
||||
## Забезпечення політики авторизації Layer 4 {#enforce-layer-4-authorization-policy}
|
||||
|
||||
Створимо [політику авторизації](/docs/reference/config/security/authorization-policy/), яка обмежує, які сервіси можуть спілкуватися з сервісом `productpage`. Політика застосовується до podʼів з міткою `app: productpage` та дозволяє виклики тільки зі службового облікового запису `cluster.local/ns/default/sa/bookinfo-gateway-istio`. (Це службовий обліковий запис, який використовується шлюзом Bookinfo, який ви розгорнули на попередньому кроці.)
|
||||
Створимо [політику авторизації](/docs/reference/config/security/authorization-policy/), яка обмежує, які сервіси можуть спілкуватися з сервісом `productpage`. Політика застосовується до podʼів з міткою `app: productpage` та дозволяє виклики тільки зі службового облікового запису `cluster.local/ns/default/sa/bookinfo-gateway-istio`. Це службовий обліковий запис, який використовується шлюзом Bookinfo, який ви розгорнули на попередньому кроці.
|
||||
|
||||
{{< text syntax=bash snip_id=deploy_l4_policy >}}
|
||||
$ kubectl apply -f - <<EOF
|
||||
|
|
@ -36,7 +36,7 @@ EOF
|
|||
|
||||
Якщо ви відкриєте застосунок Bookinfo в оглядачі (`http://localhost:8080/productpage`), ви побачите сторінку продукту, як і раніше. Однак, якщо ви спробуєте отримати доступ до сервісу `productpage` з іншого службового облікового запису, ви повинні побачити помилку.
|
||||
|
||||
Спробуйте отримати доступ до застосунку Bookinfo з podʼа `curl`:
|
||||
Спробуйте отримати доступ до застосунку Bookinfo з іншого клієнта в кластері:
|
||||
|
||||
{{< text syntax=bash snip_id=deploy_curl >}}
|
||||
$ kubectl apply -f samples/curl/curl.yaml
|
||||
|
|
|
|||
|
|
@ -47,4 +47,4 @@ $ kubectl exec deploy/curl -- sh -c "for i in \$(seq 1 100); do curl -s http://p
|
|||
|
||||
## Подальші кроки {#next-steps}
|
||||
|
||||
Ця секція завершує посібник по початку роботи з ambient mode. Ви можете перейти до розділу [Очищення](/docs/ambient/getting-started/cleanup), щоб видалити Istio, або продовжити дослідження [посібників користувача ambient mode](/docs/ambient/usage/), щоб дізнатися більше про функції та можливості Istio.
|
||||
Ця секція завершує посібник по початку роботи з ambient mode в Istio. Ви можете перейти до розділу [Очищення](/docs/ambient/getting-started/cleanup), щоб видалити Istio, або продовжити дослідження [посібників користувача ambient mode](/docs/ambient/usage/), щоб дізнатися більше про функції та можливості Istio.
|
||||
|
|
|
|||
|
|
@ -43,10 +43,10 @@ $ istioctl dashboard kiali
|
|||
Надішліть трохи трафіку до застосунку Bookinfo, щоб Kiali згенерувала графік:
|
||||
|
||||
{{< text bash >}}
|
||||
$ for i in $(seq 1 100); do curl -s http://localhost:8080/productpage; done
|
||||
$ for i in $(seq 1 100); do curl -sSI -o /dev/null http://localhost:8080/productpage; done
|
||||
{{< /text >}}
|
||||
|
||||
Далі, натисніть на графік трафіку, і ви повинні побачити застосунок Bookinfo:
|
||||
Далі, натисніть на графік трафіку, і оберіть "Default" в меню ""Select Namespaces". Ви повинні побачити застосунок Bookinfo:
|
||||
|
||||
{{< image link="./kiali-ambient-bookinfo.png" caption="Дашборд Kiali" >}}
|
||||
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 258 KiB After Width: | Height: | Size: 467 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 158 KiB After Width: | Height: | Size: 82 KiB |
|
|
@ -105,7 +105,7 @@ istio_requests_total{
|
|||
|
||||
Istio підтримує розподілені трейси через проксі Envoy. Проксі автоматично генерують відрізки трейсів від імені застосунків, які вони обробляють, що вимагає лише того, щоб застосунки пересилали відповідний контекст запиту.
|
||||
|
||||
Istio підтримує кілька бекендів для трейсів, включаючи [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/), [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/), [Lightstep](/docs/tasks/observability/distributed-tracing/lightstep/) та [Datadog](https://www.datadoghq.com/blog/monitor-istio-with-datadog/). Оператори можуть керувати частотою вибірки для генерації трейсів (тобто, швидкістю, з якою генеруються дані трейсів для кожного запиту). Це дозволяє операторам контролювати обсяг і швидкість генерації даних трейсів для їхнього mesh.
|
||||
Istio підтримує кілька бекендів для трейсів, включаючи [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/), [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/) та багато інструментів та сервісів, що підтримують [OpenTelemetry](/docs/tasks/observability/distributed-tracing/opentelemetry/). Оператори можуть керувати частотою вибірки для генерації трейсів (тобто, швидкістю, з якою генеруються дані трейсів для кожного запиту). Це дозволяє операторам контролювати обсяг і швидкість генерації даних трейсів для їхнього mesh.
|
||||
|
||||
Більше інформації про розподілені трейси з Istio можна знайти у наших [Частих питаннях про розподілені трейси](/about/faq/#distributed-tracing).
|
||||
|
||||
|
|
|
|||
|
|
@ -7,8 +7,6 @@ owner: istio/wg-environments-maintainers
|
|||
test: n/a
|
||||
---
|
||||
|
||||
{{< boilerplate telemetry-tracing-tips >}}
|
||||
|
||||
[Jaeger](https://www.jaegertracing.io/) — це система розподіленого трасування з відкритим вихідним кодом, що дозволяє користувачам моніторити та налагоджувати транзакції в складних розподілених системах.
|
||||
|
||||
## Встановлення {#installation}
|
||||
|
|
@ -27,8 +25,6 @@ $ kubectl apply -f {{< github_file >}}/samples/addons/jaeger.yaml
|
|||
|
||||
Ознайомтеся з [документацією Jaeger](https://www.jaegertracing.io/), щоб почати. Ніякі спеціальні зміни не потрібні для роботи Jaeger з Istio.
|
||||
|
||||
Після встановлення Jaeger, вам потрібно налаштувати проксі Istio для надсилання трейсів до розгортання. Це можна налаштувати за допомогою `--set meshConfig.defaultConfig.tracing.zipkin.address=<jaeger-collector-address>:9411` під час встановлення. Дивіться [`ProxyConfig.Tracing`](/docs/reference/config/istio.mesh.v1alpha1/#Tracing) для розширеної конфігурації, такої як налаштування TLS.
|
||||
|
||||
## Використання {#usage}
|
||||
|
||||
Для отримання додаткової інформації про використання Jaeger, будь ласка, ознайомтеся з [завданням Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/).
|
||||
|
|
|
|||
|
|
@ -7,8 +7,6 @@ owner: istio/wg-environments-maintainers
|
|||
test: n/a
|
||||
---
|
||||
|
||||
{{< boilerplate telemetry-tracing-tips >}}
|
||||
|
||||
[Zipkin](https://zipkin.io/) — це система розподіленого трасування, яка допомагає збирати дані про час виконання для вирішення проблем із затримкою в архітектурах сервісів. Вона підтримує як збір даних, так і їх пошук.
|
||||
|
||||
## Встановлення {#installation}
|
||||
|
|
@ -27,8 +25,6 @@ $ kubectl apply -f {{< github_file >}}/samples/addons/extras/zipkin.yaml
|
|||
|
||||
Ознайомтесь з [документацією Zipkin](https://zipkin.io/), щоб почати. Спеціальних змін для роботи Zipkin з Istio не потрібно.
|
||||
|
||||
Після встановлення Zipkin, необхідно налаштувати проксі-сервери Istio для надсилання трейсів до цього розгортання. Це можна налаштувати за допомогою параметра `--set meshConfig.defaultConfig.tracing.zipkin.address=<zipkin-collector-address>:9411` під час встановлення. Дивіться [`ProxyConfig.Tracing`](/docs/reference/config/istio.mesh.v1alpha1/#Tracing) для розширеної конфігурації, такої як налаштування TLS.
|
||||
|
||||
## Використання {#usage}
|
||||
|
||||
Для отримання додаткової інформації про використання Zipkin, будь ласка, ознайомтеся з [завданням Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/).
|
||||
|
|
|
|||
|
|
@ -36,7 +36,9 @@ $ helm install ... --set compatibilityVersion={{< istio_previous_version >}}
|
|||
|
||||
## Коли варто використовувати сумісність версій? {#when-should-i-use-compatibility-versions}
|
||||
|
||||
Рекомендується використовувати сумісність версій тільки в разі виявлення їх несумісності, а не стандартно. Кожна сумісність версії буде підтримуватися лише протягом кількох випусків, тому з часом вам доведеться перейти на нову поведінку. Зараз передбачається, що кожна сумісність версій залишатиметься принаймні для двох версій, хоча це може змінитися.
|
||||
Сумісність версій слід використовувати лише тоді, коли існує несумісність між випусками, як тимчасовий захід. Ви повинні планувати перехід на нову поведінку, як тільки це стане можливим.
|
||||
|
||||
Сумісність версій для випуску буде вилучено і більше не підтримуватиметься, коли випуск, до якого вони відносяться, досягне кінця свого життєвого циклу. Зверніться до [стану підтримки поточного випуску Istio](/docs/releases/supported-releases/#support-status-of-istio-releases) для отримання інформації про стан конкретних випусків.
|
||||
|
||||
Щоб допомогти визначити, чи потрібно використовувати сумісність версій, можна скористатися командою `istioctl x precheck` з прапорцем `--from-version`. Наприклад, якщо ви оновлюєтесь з версії {{< istio_previous_version >}}:
|
||||
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ test: n/a
|
|||
|
||||
Ця сторінка описує вбудовані конфігураційні профілі, які можна використовувати під час [встановлення Istio](/docs/setup/install/istioctl/). Профілі надають можливість налаштування панелі управління Istio та sidecarʼів для панелі даних Istio.
|
||||
|
||||
Ви можете почати з одного з вбудованих конфігураційних профілів Istio, а потім додатково [налаштувати конфігурацію](/docs/setup/additional-setup/customize-installation/) відповідно до ваших специфічних потреб. Зараз доступні такі вбудовані конфігураційні профілі:
|
||||
Ви можете почати з одного з [вбудованих конфігураційних профілів Istio]({{< github_tree >}}/manifests/profiles), а потім додатково [налаштувати конфігурацію](/docs/setup/additional-setup/customize-installation/) відповідно до ваших специфічних потреб. Зараз доступні такі вбудовані конфігураційні профілі:
|
||||
|
||||
1. **default**: включає компоненти відповідно до стандартних налаштувань [API IstioOperator](/docs/reference/config/istio.operator.v1alpha1/). Цей профіль рекомендується для розгортання в операційному оточені та для {{< gloss "основний кластер" >}}primary кластерів{{< /gloss >}} у [мультикластерній мережі](/docs/ops/deployment/deployment-models/#multiple-clusters). Ви можете переглянути стандартні налаштування, виконавши команду `istioctl profile dump`.
|
||||
|
||||
|
|
|
|||
|
|
@ -140,14 +140,7 @@ spec:
|
|||
|
||||
### Налаштування шлюзів {#configure-gateways}
|
||||
|
||||
Шлюзи є особливим типом компонента, оскільки можна визначити кілька шлюзів для вхідного та вихідного трафіку. В [API `IstioOperator`](/docs/reference/config/istio.operator.v1alpha1/) шлюзи визначаються як список. Профіль `default` встановлює один шлюз для вхідного трафіку, названий `istio-ingressgateway`. Ви можете перевірити стандартне значення для цього шлюзу:
|
||||
|
||||
{{< text bash >}}
|
||||
$ istioctl profile dump --config-path components.ingressGateways
|
||||
$ istioctl profile dump --config-path values.gateways.istio-ingressgateway
|
||||
{{< /text >}}
|
||||
|
||||
Ці команди покажуть як налаштування `IstioOperator`, так і Helm для шлюзу, які використовуються разом для визначення згенерованих ресурсів шлюзу. Вбудовані шлюзи можна налаштовувати так само як і будь-який інший компонент.
|
||||
Шлюзи є особливим типом компонента, оскільки можна визначити кілька шлюзів для вхідного та вихідного трафіку. В [API `IstioOperator`](/docs/reference/config/istio.operator.v1alpha1/) шлюзи визначаються як список. Профіль `default` встановлює один шлюз для вхідного трафіку, названий `istio-ingressgateway`. Ви можете [перевірити стандартні значення для цього шлюзу]({{< github_tree >}}/manifests/charts/gateways/istio-ingress/values.yaml). Вбудовані шлюзи можна налаштовувати так само як і будь-який інший компонент.
|
||||
|
||||
{{< warning >}}
|
||||
З версії 1.7 і пізніше імʼя шлюзу завжди повинно бути зазначене при накладанні. Відсутність імені більше не призводить до стандартного використання `istio-ingressgateway` або `istio-egressgateway`.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Jaeger
|
||||
description: Дізнайтеся, як налаштувати проксі для відправки запитів трейсингу до Jaeger.
|
||||
weight: 20
|
||||
weight: 6
|
||||
keywords: [телеметрія,трейсинг,jaeger,спан,порт-форвардинг,telemetry,tracing,jaeger,span,port-forwarding]
|
||||
aliases:
|
||||
- /uk/docs/tasks/telemetry/distributed-tracing/jaeger/
|
||||
|
|
@ -19,13 +19,55 @@ test: yes
|
|||
|
||||
1. Слідуйте [документації з установки Jaeger](/docs/ops/integrations/jaeger/#installation) для розгортання Jaeger у вашому кластері.
|
||||
|
||||
1. При увімкненні трейсингу ви можете налаштувати швидкість відбору, яку Istio використовує для трейсингу. Використовуйте опцію `meshConfig.defaultConfig.tracing.sampling` під час установки для [налаштування швидкості відбору](/docs/tasks/observability/distributed-tracing/mesh-and-proxy-config/#customizing-trace-sampling). Стандартно швидкість відбору становить 1%.
|
||||
|
||||
1. Розгорніть [демонстраційний застосунок Bookinfo](/docs/examples/bookinfo/#deploying-the-application).
|
||||
|
||||
## Налаштування Istio для розподіленого трейсингу {#configure-istio-for-distributed-tracing}
|
||||
|
||||
### Налаштування постачальника розширень {#configure-an-extension-provider}
|
||||
|
||||
Встановіть Istio з [постачальником розширень](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider) посилаючись на сервіс колектора Jaeger:
|
||||
|
||||
{{< text bash >}}
|
||||
$ cat <<EOF > ./tracing.yaml
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
kind: IstioOperator
|
||||
spec:
|
||||
meshConfig:
|
||||
enableTracing: true
|
||||
defaultConfig:
|
||||
tracing: {} # disable legacy MeshConfig tracing options
|
||||
extensionProviders:
|
||||
- name: jaeger
|
||||
opentelemetry:
|
||||
port: 4317
|
||||
service: jaeger-collector.istio-system.svc.cluster.local
|
||||
EOF
|
||||
$ istioctl install -f ./tracing.yaml --skip-confirmation
|
||||
{{< /text >}}
|
||||
|
||||
## Увімкнення трейсів {#enable-tracing}
|
||||
|
||||
Увімкніть трейси застосувавши наступну конфігурацію:
|
||||
|
||||
Enable tracing by applying the following configuration:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f - <<EOF
|
||||
apiVersion: telemetry.istio.io/v1
|
||||
kind: Telemetry
|
||||
metadata:
|
||||
name: mesh-default
|
||||
namespace: istio-system
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: jaeger
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
## Доступ до панелі управління {#accessing-the-dashboard}
|
||||
|
||||
[Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways) описує, як налаштувати доступ до надбудов Istio через шлюз.
|
||||
Завдання [Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways) описує, як налаштувати доступ до надбудов Istio через шлюз.
|
||||
|
||||
Для тестування (та тимчасового доступу) ви також можете використовувати порт-форвардинг. Використовуйте наступне, припускаючи, що ви розгорнули Jaeger у просторі імен `istio-system`:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,179 +0,0 @@
|
|||
---
|
||||
title: Lightstep
|
||||
description: Як налаштувати проксі для надсилання трейсів до Lightstep.
|
||||
weight: 70
|
||||
keywords: [telemetry,tracing,lightstep]
|
||||
aliases:
|
||||
- /docs/tasks/telemetry/distributed-tracing/lightstep/
|
||||
owner: istio/wg-policies-and-telemetry-maintainers
|
||||
test: no
|
||||
---
|
||||
|
||||
{{< boilerplate telemetry-tracing-tips >}}
|
||||
|
||||
Це завдання показує, як налаштувати Istio для збору відрізків (span) трейсингу та надсилання їх до [Lightstep](https://lightstep.com). Lightstep дозволяє аналізувати 100% недискретизованих даних транзакцій з великомасштабного промислового програмного забезпечення для створення значущих розподілених трейсів і метрик, які допомагають пояснити поведінку продуктивності і прискорити аналіз першопричин. В кінці цього завдання Istio надсилатиме відрізки трейсів з проксі до пулу Lightstep Satellite, роблячи їх доступними у вебінтерфейсі. Стандартно перехоплюються всі HTTP-запити (щоб побачити наскрізні трейси, ваш код повинен пересилати OT-заголовки, навіть якщо він не приєднується до трейсів).
|
||||
|
||||
Якщо ви хочете збирати відрізки трейсів безпосередньо з Istio (і не додавати специфічні інструменти безпосередньо до вашого коду), вам не потрібно налаштовувати жодні трейсери, якщо ваші сервіси передають [HTTP заголовки, згенеровані трейсами](https://www.envoyproxy.io/docs/envoy/latest/configuration/http_conn_man/headers#config-http-conn-man-headers-x-ot-span-context).
|
||||
|
||||
Це завдання використовує [Bookinfo](/docs/examples/bookinfo/) як демонстраційний застосунок.
|
||||
|
||||
## Перед початком {#before-you-begin}
|
||||
|
||||
1. Переконайтеся, що у вас є обліковий запис Lightstep. [Зареєструйтесь](https://go.lightstep.com/trial) на безкоштовний пробний період Lightstep.
|
||||
|
||||
1. Якщо ви використовуєте [локальні Satellites](https://docs.lightstep.com/docs/learn-about-satellites#on-premise-satellites), переконайтеся, що у вас є налаштований пул супутників з TLS сертифікатами та захищеним GRPC портом. Дивіться [Встановлення та налаштування супутників](https://docs.lightstep.com/docs/install-and-configure-satellites) для отримання деталей про налаштування супутників.
|
||||
|
||||
Для [публічних Satellites Lightstep](https://docs.lightstep.com/docs/learn-about-satellites#public-satellites) або [супутників для розробників](https://docs.lightstep.com/docs/learn-about-satellites#developer-satellites) ваші супутники вже налаштовані. Однак вам потрібно завантажити [цей сертифікат](https://docs.lightstep.com/docs/instrument-with-istio-as-your-service-mesh#cacertpem-file) у локальну теку.
|
||||
|
||||
1. Переконайтеся, що у вас є [токен доступу Lightstep](https://docs.lightstep.com/docs/create-and-manage-access-tokens). Токени доступу дозволяють вашій програмі спілкуватися з вашим проєктом Lightstep.
|
||||
|
||||
## Розгортання Istio {#deploy-istio}
|
||||
|
||||
Як ви розгортаєте Istio, залежить від типу супутника, який ви використовуєте.
|
||||
|
||||
### Розгортання Istio з локальними супутниками {#deploy-istio-with-on-premise-satellites}
|
||||
|
||||
Ці інструкції не припускають використання TLS. Якщо ви використовуєте TLS для вашого пулу супутників, дотримуйтеся конфігурації для [Публічного пулу супутників](#deploy-istio-with-public-or-developer-mode-satellites), але використовуйте свій сертифікат та адресу вашого пулу (`host:port`).
|
||||
|
||||
1. Вам потрібно розгорнути Istio з адресою вашого супутника у форматі `<Host>:<Port>`, наприклад `lightstep-satellite.lightstep:9292`. Ви знайдете це у вашому [файлі конфігурації](https://docs.lightstep.com/docs/satellite-configuration-parameters#ports).
|
||||
|
||||
1. Розгорніть Istio з наступними параметрами конфігурації:
|
||||
- `global.proxy.tracer="lightstep"`
|
||||
- `meshConfig.defaultConfig.tracing.sampling=100`
|
||||
- `meshConfig.defaultConfig.tracing.lightstep.address="<satellite-address>"`
|
||||
- `meshConfig.defaultConfig.tracing.lightstep.accessToken="<access-token>"`
|
||||
|
||||
Ви можете встановити ці параметри за допомогою синтаксису `--set key=value` під час виконання команди встановлення. Наприклад:
|
||||
|
||||
{{< text bash >}}
|
||||
$ istioctl install \
|
||||
--set global.proxy.tracer="lightstep" \
|
||||
--set meshConfig.defaultConfig.tracing.sampling=100 \
|
||||
--set meshConfig.defaultConfig.tracing.lightstep.address="<satellite-address>" \
|
||||
--set meshConfig.defaultConfig.tracing.lightstep.accessToken="<access-token>" \
|
||||
{{< /text >}}
|
||||
|
||||
### Розгортання Istio з публічними або супутниками для розробників {#deploy-istio-with-public-or-developer-mode-satellites}
|
||||
|
||||
Слідуйте цим крокам, якщо ви використовуєте публічні або супутники для розробників, або якщо ви використовуєте локальні супутники з сертифікатом TLS.
|
||||
|
||||
1. Зберігайте сертифікат авторитету вашого пулу супутників як секрет у просторі імен `default` та `istio-system`, останній для використання шлюзами Istio. Завантажте і використовуйте [цей сертифікат](https://docs.lightstep.com/docs/instrument-with-istio-as-your-service-mesh#cacertpem-file). Якщо ви розгортаєте застосунок Bookinfo в іншому просторі імен, створіть секрет у цьому просторі імен.
|
||||
|
||||
{{< text bash >}}
|
||||
$ CACERT=$(cat Cert_Auth.crt | base64) # Cert_Auth.crt містить необхідний CACert
|
||||
$ NAMESPACE=default
|
||||
{{< /text >}}
|
||||
|
||||
{{< text bash >}}
|
||||
$ cat <<EOF | kubectl apply -f -
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
metadata:
|
||||
name: lightstep.cacert
|
||||
namespace: $NAMESPACE
|
||||
labels:
|
||||
app: lightstep
|
||||
type: Opaque
|
||||
data:
|
||||
cacert.pem: $CACERT
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
1. Розгорніть Istio з наступними параметрами конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
global:
|
||||
proxy:
|
||||
tracer: "lightstep"
|
||||
meshConfig:
|
||||
defaultConfig:
|
||||
tracing:
|
||||
lightstep:
|
||||
address: "ingest.lightstep.com:443"
|
||||
accessToken: "<access-token>"
|
||||
sampling: 100
|
||||
tlsSettings:
|
||||
mode: "SIMPLE"
|
||||
# Вказівка сертифіката CA тут монтує том `lightstep.cacert`
|
||||
# до всіх sidecar за замовчуванням.
|
||||
caCertificates="/etc/lightstep/cacert.pem"
|
||||
components:
|
||||
ingressGateways:
|
||||
# Том секрету `lightstep.cacert` потрібно змонтувати до шлюзів через k8s overlay.
|
||||
- name: istio-ingressgateway
|
||||
enabled: true
|
||||
k8s:
|
||||
overlays:
|
||||
- kind: Deployment
|
||||
name: istio-ingressgateway
|
||||
patches:
|
||||
- path: spec.template.spec.containers[0].volumeMounts[-1]
|
||||
value: |
|
||||
name: lightstep-certs
|
||||
mountPath: /etc/lightstep
|
||||
readOnly: true
|
||||
- path: spec.template.spec.volumes[-1]
|
||||
value: |
|
||||
name: lightstep-certs
|
||||
secret:
|
||||
secretName: lightstep.cacert
|
||||
optional: true
|
||||
{{< /text >}}
|
||||
|
||||
## Встановлення та запуск Bookinfo {#install-and-run-the-bookinfo-app}
|
||||
|
||||
1. Слідуйте [інструкціям для розгортання демонстраційного застосунку Bookinfo](/docs/examples/bookinfo/#deploying-the-application).
|
||||
|
||||
1. Слідуйте [інструкціям для створення шлюзу для застосунку Bookinfo](/docs/examples/bookinfo/#determine-the-ingress-ip-and-port).
|
||||
|
||||
1. Щоб перевірити успішність попереднього кроку, підтверджуйте, що ви встановили змінну середовища `GATEWAY_URL` у вашій оболонці.
|
||||
|
||||
1. Надішліть трафік до демонстраційного застосунку.
|
||||
|
||||
{{< text bash >}}
|
||||
$ curl http://$GATEWAY_URL/productpage
|
||||
{{< /text >}}
|
||||
|
||||
## Візуалізація даних трейсингу {#visualize-trace-data}
|
||||
|
||||
1. Завантажте [вебінтерфейс Lightstep](https://app.lightstep.com/). Ви побачите три сервіси Bookinfo в Service Directory.
|
||||
|
||||
{{< image link="./istio-services.png" caption="Сервіси Bookfinder у Service Directory" >}}
|
||||
|
||||
1. Перейдіть до Explorer.
|
||||
|
||||
{{< image link="./istio-explorer.png" caption="Explorer" >}}
|
||||
|
||||
1. Знайдіть рядок запиту зверху. Рядок запиту дозволяє вам інтерактивно фільтрувати результати за **Сервісом**, **Операцією** та **Значеннями теґів**.
|
||||
|
||||
1. Виберіть `productpage.default` зі списку **Сервіс**.
|
||||
|
||||
1. Натисніть **Run**. Ви побачите щось подібне до:
|
||||
|
||||
{{< image link="./istio-tracing-list-lightstep.png" caption="Explorer" >}}
|
||||
|
||||
1. Натисніть на перший рядок у таблиці прикладів трейсів під гістограмою затримки, щоб переглянути деталі відповідно до вашого оновлення `/productpage`. Сторінка потім виглядає так:
|
||||
|
||||
{{< image link="./istio-tracing-details-lightstep.png" caption="Детальний перегляд трейсів" >}}
|
||||
|
||||
Скріншот показує, що трейс складається з набору відрізків. Кожен відрізок відповідає за один з сервісів Bookinfo, викликаних під час виконання запиту `/productpage`.
|
||||
|
||||
Два відрізки в трейсингу представляють кожен RPC. Наприклад, виклик з `productpage` до `reviews` починається з відрізку, позначеного операцією `reviews.default.svc.cluster.local:9080/*` і сервісом `productpage.default: proxy client`. Цей сервіс представляє клієнтський відрізок виклику. Скріншот показує, що виклик зайняв 15.30 мс. Другий відрізок позначений операцією `reviews.default.svc.cluster.local:9080/*` і сервісом `reviews.default: proxy server`. Другий відрізок є дитиною першого відрізку і представляє серверний відрізок виклику. Скріншот показує, що виклик зайняв 14.60 мс.
|
||||
|
||||
## Зразки трейсів {#trace-sampling}
|
||||
|
||||
Istio захоплює трейсинги з налаштовуваним відсотком зразків трейсів. Щоб дізнатися, як змінити відсоток зразків трейсів, відвідайте [секцію зразків трейсів розподіленого трейсингу](/docs/tasks/observability/distributed-tracing/mesh-and-proxy-config/#customizing-trace-sampling).
|
||||
|
||||
При використанні Lightstep, ми не рекомендуємо зменшувати відсоток зразків трейсів нижче 100%. Щоб впоратися з високим трафіком у мережі, розгляньте можливість масштабування розміру вашого пулу супутників.
|
||||
|
||||
## Очищення {#cleanup}
|
||||
|
||||
Якщо ви не плануєте подальші завдання, видаліть демонстраційний застосунок Bookinfo і будь-які секрети Lightstep з вашого кластера.
|
||||
|
||||
1. Щоб видалити застосунок Bookinfo, дотримуйтеся [інструкцій з очищення Bookinfo](/docs/examples/bookinfo/#cleanup).
|
||||
|
||||
1. Видаліть секрет, створений для Lightstep:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl delete secret lightstep.cacert
|
||||
{{< /text >}}
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 434 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 273 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 323 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 342 KiB |
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Налаштування трейсингу за допомогою MeshConfig та анотацій Pod
|
||||
description: Як налаштувати параметри трейсингу за допомогою MeshConfig та анотацій Pod.
|
||||
weight: 60
|
||||
weight: 3
|
||||
keywords: [telemetry,tracing]
|
||||
aliases:
|
||||
- /uk/docs/tasks/observability/distributed-tracing/configurability/
|
||||
|
|
@ -13,13 +13,13 @@ status: Beta
|
|||
|
||||
{{< boilerplate telemetry-tracing-tips >}}
|
||||
|
||||
Istio надає можливість налаштувати розширені параметри трейсингу, такі як швидкість вибірки та додавання власних теґів до відрізків (span). Вибірка є бета-функцією, але додавання власних теґів і довжина теґів трейсингу вважаються у розробці для цього випуску.
|
||||
Istio надає можливість налаштувати розширені параметри трейсингу, такі як швидкість вибірки та додавання власних теґів до відрізків (span).
|
||||
|
||||
## Перед початком {#before-you-begin}
|
||||
|
||||
1. Переконайтеся, що ваші застосунки передають заголовки трейсингу, як описано [тут](/docs/tasks/observability/distributed-tracing/overview/).
|
||||
|
||||
1. Слідуйте керівництву з установки трейсингу, яке розташоване в розділі [Інтеграції](/docs/ops/integrations/) відповідно до вашого вибраного бекенду трейсингу, щоб встановити відповідний застосунок та налаштувати ваші проксі Istio для надсилання трейсів на розгортання трейсингу.
|
||||
1. Слідуйте керівництву з установки трейсингу, яке розташоване в розділі [Інтеграції](/docs/ops/integrations/) відповідно до вашого вибраного бекенду трейсингу, щоб встановити відповідне програмне забезпечення та налаштувати ваші проксі Istio для надсилання трейсів на розгортання трейсингу.
|
||||
|
||||
## Доступні конфігурації трейсингу {#available-tracing-configurations}
|
||||
|
||||
|
|
@ -33,15 +33,13 @@ Istio надає можливість налаштувати розширені
|
|||
|
||||
Налаштувати параметри трейсингу можна двома способами:
|
||||
|
||||
1. Глобально за допомогою опцій `MeshConfig`.
|
||||
1. Глобально, за допомогою опцій `MeshConfig`.
|
||||
|
||||
1. За допомогою анотацій на кожний pod для налаштування під конкретне робоче навантаження.
|
||||
|
||||
{{< warning >}}
|
||||
Щоб нова конфігурація трейсингу набула чинності для будь-якого з цих варіантів, вам потрібно перезапустити podʼи, в які вставлені проксі Istio.
|
||||
{{< /warning >}}
|
||||
|
||||
{{< warning >}}
|
||||
Будь-які анотації podʼів, додані для конфігурації трейсингу, перевизначають глобальні налаштування. Щоб зберегти будь-які глобальні налаштування, ви повинні скопіювати їх з
|
||||
глобальної конфігурації мережі до анотацій podʼа разом зі специфічними налаштуваннями для робочого навантаження. Особливо, переконайтеся, що адреса бекенду трейсингу завжди вказана в анотаціях, щоб забезпечити правильну передачу трейсів для робочого навантаження.
|
||||
{{< /warning >}}
|
||||
|
|
@ -119,7 +117,9 @@ spec:
|
|||
...
|
||||
{{< /text >}}
|
||||
|
||||
## Налаштування вибірки трейсів {#customizing-trace-sampling}
|
||||
## Налаштування {#customization}
|
||||
|
||||
### Налаштування вибірки трейсів {#customizing-trace-sampling}
|
||||
|
||||
Опція швидкості вибірки може бути використана для контролю відсотка запитів, які повідомляються вашій системі трейсингу. Це повинно бути налаштоване залежно від вашого трафіку в мережі та кількості даних трейсингу, які ви хочете зібрати. Стандартно, швидкість вибірки становить 1%.
|
||||
|
||||
|
|
@ -145,7 +145,7 @@ spec:
|
|||
|
||||
Швидкість вибірки повинна бути в межах від 0.0 до 100.0 з точністю 0.01. Наприклад, щоб трейсити 5 запитів з кожних 10000, використовуйте значення 0.05 тут.
|
||||
|
||||
## Налаштування теґів трейсингу {#customizing-tracing-tags}
|
||||
### Налаштування теґів трейсингу {#customizing-tracing-tags}
|
||||
|
||||
Власні теґи можуть бути додані до відрізків (span) на основі літералів, змінних середовища та заголовків клієнтських запитів для надання додаткової інформації у відрізках, специфічних для вашого середовища.
|
||||
|
||||
|
|
@ -209,7 +209,7 @@ spec:
|
|||
defaultValue: <VALUE> # необовʼязково
|
||||
{{< /text >}}
|
||||
|
||||
## Налаштування довжини теґів трейсингу {#customizing-tracing-tag-length}
|
||||
### Налаштування довжини теґів трейсингу {#customizing-tracing-tag-length}
|
||||
|
||||
Стандартно, максимальна довжина шляху запиту, включеного як частина теґа `HttpUrl`, становить 256. Щоб змінити цю максимальну довжину, додайте наступне до вашого файлу `tracing.yaml`.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,21 +1,24 @@
|
|||
---
|
||||
title: OpenTelemetry
|
||||
description: Дізнайтеся, як налаштувати проксі для надсилання трейсів OpenTelemetry до Колектора.
|
||||
weight: 30
|
||||
description: Дізнайтеся, як налаштувати проксі для надсилання трейсів у форматі OpenTelemetry.
|
||||
weight: 5
|
||||
keywords: [телеметрія,трейсинг,opentelemetry,спан,порт-форвардинг,telemetry,tracing,opentelemetry,span,port-forwarding]
|
||||
aliases:
|
||||
- /uk/docs/tasks/telemetry/distributed-tracing/opentelemetry/
|
||||
- /uk/docs/tasks/observability/distributed-tracing/lightstep/
|
||||
- /latest/uk/docs/tasks/observability/distributed-tracing/lightstep/
|
||||
owner: istio/wg-policies-and-telemetry-maintainers
|
||||
test: yes
|
||||
---
|
||||
|
||||
Після завершення цього завдання ви зможете зрозуміти, як ваш застосунок може брати участь у трейсингу з [OpenTelemetry](https://www.opentelemetry.io/), незалежно від мови, фреймворка або платформи, який ви використовуєте для створення застосунку.
|
||||
|
||||
Це завдання використовує [Bookinfo](/docs/examples/bookinfo/) як демонстраційний застосунок та
|
||||
[OpenTelemetry Collector](https://opentelemetry.io/docs/collector/) як приймач трейсів.
|
||||
[OpenTelemetry](https://opentelemetry.io/) (OTel) — це незалежна від постачальника платформа з відкритим вихідним кодом для вимірювання, генерації, збору та експорту телеметричних даних. Трейси [OpenTelemetry Protocol](https://opentelemetry.io/docs/specs/otlp/) (OTLP) можна надсилати до [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/), а також до багатьох комерційних сервісів.
|
||||
|
||||
Щоб дізнатися, як Istio обробляє трейсинг, відвідайте [огляд цього завдання](../overview/).
|
||||
|
||||
Після завершення цього завдання ви зможете зрозуміти, як ваш застосунок може брати участь у трейсингу з [OpenTelemetry](https://www.opentelemetry.io/), незалежно від мови, фреймворка або платформи, який ви використовуєте для створення застосунку.
|
||||
|
||||
Це завдання використовує [Bookinfo](/docs/examples/bookinfo/) як демонстраційний застосунок та [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/) як приймач трейсів. Приклад надсилання трейсів безпосередньо до OTLP-сумісного бекенду наведено у [завданні Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/).
|
||||
|
||||
## Розгортання OpenTelemetry Collector {#deploy-the-opentelemetry-collector}
|
||||
|
||||
{{< boilerplate start-otel-collector-service >}}
|
||||
|
|
|
|||
|
|
@ -11,19 +11,30 @@ test: n/a
|
|||
|
||||
Розподілений трейсинг дозволяє користувачам відстежувати запит через мережу, розподілену між кількома сервісами. Це дозволяє глибше зрозуміти затримки запиту, серіалізацію та паралелізм через візуалізацію.
|
||||
|
||||
Istio використовує [розподілений трейсинг Envoy](https://www.envoyproxy.io/docs/envoy/v1.12.0/intro/arch_overview/observability/tracing), щоб забезпечити інтеграцію трейсингу з коробки. Зокрема, Istio надає можливість встановлення різних бекендів трейсингу та конфігурації проксі для автоматичного надсилання трейс-спанів до них. Дивіться документацію завдань [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/), [Jaeger](/docs/tasks/observability/distributed-tracing/jaeger/), та [Lightstep](/docs/tasks/observability/distributed-tracing/lightstep/) про те, як Istio працює з цими системами трейсингу.
|
||||
Istio використовує [розподілений трейсинг Envoy](https://www.envoyproxy.io/docs/envoy/v1.12.0/intro/arch_overview/observability/tracing), щоб забезпечити інтеграцію трейсингу з коробки.
|
||||
|
||||
## Пропагування контексту трейсингу {#trace-context-propagation}
|
||||
Більшість бекендів трейсингу зараз приймають протокол [OpenTelemetry](/docs/tasks/observability/distributed-tracing/opentelemetry/) для отримання трейсів, хоча Istio також підтримує застарілі протоколи для таких проєктів, як [Zipkin](/docs/tasks/observability/distributed-tracing/zipkin/) та [Apache SkyWalking](/docs/tasks/observability/distributed-tracing/skywalking/).
|
||||
|
||||
## Налаштування трейсингу {#configuring-tracing}
|
||||
|
||||
Istio надає [Telemetry API](/docs/tasks/observability/distributed-tracing/telemetry-api/), за допомогою якого можна налаштувати розподілений трейсинг, включаючи вибір провайдера, встановлення [частоти дискретизації](/docs/tasks/observability/distributed-tracing/sampling/) та зміну заголовків.
|
||||
|
||||
## Постачальники розширень {#extension-providers}
|
||||
|
||||
[Провайдери розширень](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider) визначаються у `MeshConfig` і дозволяють визначити конфігурацію для бекенду трейсингу. Підтримувані провайдери: OpenTelemetry, Zipkin, SkyWalking, Datadog та Stackdriver.
|
||||
|
||||
## Створення застосунків для підтримки поширення контексту трейсингу {#building-applications-to-support-trace-context-propagation}
|
||||
|
||||
Хоча проксі Istio можуть автоматично надсилати відрізки, додаткова інформація потрібна для зʼєднання цих відрізків в один трейс. Застосунки повинні пропагувати цю інформацію в HTTP-заголовках, щоб, коли проксі надсилають відрізки, бекенд міг обʼєднати їх у єдиний трейс.
|
||||
|
||||
Для цього кожний застосунок має збирати заголовки з кожного вхідного запиту і передавати заголовки всім вихідним запитам, що ініціюються цим вхідним запитом. Вибір заголовків для передачі залежить від налаштованого бекенду трейсингу. Набір заголовків для передачі описується на кожній сторінці специфічних завдань трейсингу. Ось короткий огляд:
|
||||
|
||||
Усі застосунки повинні передавати наступний заголовок:
|
||||
Усі застосунки повинні передавати наступні заголовки:
|
||||
|
||||
* `x-request-id`: це заголовок, специфічний для Envoy, який використовується для послідовного відбору логів та трейсів.
|
||||
* `traceparent` та `tracestate`: [W3C standard headers](https://www.w3.org/TR/trace-context/)
|
||||
|
||||
Для Zipkin, Jaeger та Stackdriver слід передавати формат B3 multi-header:
|
||||
Для Zipkin слід передавати [формат B3 multi-header](https://github.com/openzipkin/b3-propagation):
|
||||
|
||||
* `x-b3-traceid`
|
||||
* `x-b3-spanid`
|
||||
|
|
@ -31,39 +42,17 @@ Istio використовує [розподілений трейсинг Envoy]
|
|||
* `x-b3-sampled`
|
||||
* `x-b3-flags`
|
||||
|
||||
Ці заголовки підтримуються Zipkin, Jaeger та багатьма іншими інструментами.
|
||||
Щодо комерційних інструментів спостереження, зверніться до їхньої документації.
|
||||
|
||||
Для Datadog слід передавати наступні заголовки. Передача цих заголовків автоматично обробляється бібліотеками клієнтів Datadog для багатьох мов і фреймворків.
|
||||
|
||||
* `x-datadog-trace-id`.
|
||||
* `x-datadog-parent-id`.
|
||||
* `x-datadog-sampling-priority`.
|
||||
|
||||
Для Lightstep слід передавати заголовок контексту відрізку OpenTracing:
|
||||
|
||||
* `x-ot-span-context`
|
||||
|
||||
Для Stackdriver ви можете вибрати один з наступних заголовків замість формату B3 multi-header.
|
||||
|
||||
* `grpc-trace-bin`: стандартний заголовок трейсингу grpc.
|
||||
* `traceparent`: стандарт W3C Trace Context для трейсингу. Підтримується OpenTelemetry та збільшується кількість бібліотек клієнтів Jaeger.
|
||||
* `x-cloud-trace-context`: використовується API продуктів Google Cloud.
|
||||
|
||||
Якщо подивитися на приклад сервісу Python `productpage`, наприклад, ви побачите, що застосунок витягує необхідні заголовки для всіх трейсерів з HTTP-запиту за допомогою бібліотек [OpenTracing](https://opentracing.io/):
|
||||
Якщо подивитися на [приклад сервісу Python `productpage`]({{< github_blob >}}/samples/bookinfo/src/productpage/productpage.py#L125), наприклад, ви побачите, що застосунок витягує необхідні заголовки для всіх трейсерів з HTTP-запиту за допомогою бібліотек OpenTelemetry:
|
||||
|
||||
{{< text python >}}
|
||||
def getForwardHeaders(request):
|
||||
headers = {}
|
||||
|
||||
# x-b3-*** заголовки можуть бути заповнені за допомогою відрізку opentracing
|
||||
span = get_current_span()
|
||||
carrier = {}
|
||||
tracer.inject(
|
||||
span_context=span.context,
|
||||
format=Format.HTTP_HEADERS,
|
||||
carrier=carrier)
|
||||
|
||||
headers.update(carrier)
|
||||
# x-b3-*** заголовки можуть бути поширені за допомогою відрізку OpenTelemetry
|
||||
ctx = propagators.extract(carrier={k.lower(): v for k, v in request.headers})
|
||||
propagators.inject(headers, ctx)
|
||||
|
||||
# ...
|
||||
|
||||
|
|
@ -92,7 +81,7 @@ def getForwardHeaders(request):
|
|||
return headers
|
||||
{{< /text >}}
|
||||
|
||||
Застосунок reviews (Java) робить щось подібне за допомогою `requestHeaders`:
|
||||
[Застосунок reviews]({{< github_blob >}}/samples/bookinfo/src/reviews/reviews-application/src/main/java/application/rest/LibertyRestEndpoint.java#L186) (Java) робить щось подібне за допомогою `requestHeaders`:
|
||||
|
||||
{{< text java >}}
|
||||
@GET
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Вибірка трейсів
|
||||
title: Налаштування вибірки трейсів
|
||||
description: Досліджуйте різні підходи до налаштування вибірки трейсів на проксі.
|
||||
weight: 40
|
||||
weight: 4
|
||||
keywords: [sampling, telemetry, tracing, opentelemetry]
|
||||
owner: istio/wg-policies-and-telemetry-maintainers
|
||||
test: yes
|
||||
|
|
@ -19,10 +19,6 @@ Istio надає кілька способів налаштування вибі
|
|||
|
||||
1. Власний OpenTelemetry Sampler: реалізація власного семплера, яка повинна бути поєднана з `OpenTelemetryTracingProvider`.
|
||||
|
||||
1. Розгорніть OpenTelemetry Collector
|
||||
|
||||
{{< boilerplate start-otel-collector-service >}}
|
||||
|
||||
### Вибірка за відсотком {#percentage-sampler}
|
||||
|
||||
{{< boilerplate telemetry-tracing-tips >}}
|
||||
|
|
@ -33,7 +29,46 @@ Istio надає кілька способів налаштування вибі
|
|||
|
||||
Є три способи налаштування випадкової швидкості вибірки:
|
||||
|
||||
#### Глобально через `MeshConfig` {#globally-via-meshconfig}
|
||||
#### Telemetry API {#telemetry-api}
|
||||
|
||||
Вибірку можна налаштувати для різних масштабів: для всієї mesh-мережі, для простору імен або для конкретного навантаження, що забезпечує велику гнучкість. Щоб дізнатися більше, будь ласка, ознайомтеся з документацією [Telemetry API](/docs/tasks/observability/telemetry/).
|
||||
|
||||
Встановіть Istio без налаштування `sampling` всередині `defaultConfig`:
|
||||
|
||||
{{< text syntax=bash snip_id=install_without_sampling >}}
|
||||
$ cat <<EOF | istioctl install -y -f -
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
kind: IstioOperator
|
||||
spec:
|
||||
meshConfig:
|
||||
enableTracing: true
|
||||
extensionProviders:
|
||||
- name: otel-tracing
|
||||
opentelemetry:
|
||||
port: 4317
|
||||
service: opentelemetry-collector.observability.svc.cluster.local
|
||||
resource_detectors:
|
||||
environment: {}
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
Увімкніть провайдера трейсингу через Telemetry API та задайте `randomSamplingPercentage`.
|
||||
|
||||
{{< text syntax=bash snip_id=enable_telemetry_with_sampling >}}
|
||||
$ kubectl apply -f - <<EOF
|
||||
apiVersion: telemetry.istio.io/v1
|
||||
kind: Telemetry
|
||||
metadata:
|
||||
name: otel-demo
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: otel-tracing
|
||||
randomSamplingPercentage: 10
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
#### Використання `MeshConfig` {#using-meshconfig}
|
||||
|
||||
Випадкова вибірка за відсотком може бути налаштована глобально через `MeshConfig`.
|
||||
|
||||
|
|
@ -73,7 +108,7 @@ spec:
|
|||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
#### Анотація Pod `proxy.istio.io/config` {#pod-annotation-proxyistioioconfig}
|
||||
#### Використання анотації `proxy.istio.io/config` {#using-the-proxyistioioconfig-annotation}
|
||||
|
||||
Ви можете додати анотацію `proxy.istio.io/config` до метаданих вашого Pod, щоб перевизначити будь-які налаштування вибірки на рівні мережі.
|
||||
|
||||
|
|
@ -98,48 +133,9 @@ spec:
|
|||
...
|
||||
{{< /text >}}
|
||||
|
||||
#### Telemetry API {#telemetry-api}
|
||||
|
||||
Випадкову вибірку за відсотком також можна налаштувати через Telemetry API. Через Telemetry API вибірку можна налаштувати на різних масштабах: глобально, на рівні простору імен або на рівні навантаження, що забезпечує велику гнучкість. Щоб дізнатися більше, будь ласка, ознайомтеся з документацією [Telemetry API](/docs/tasks/observability/telemetry/).
|
||||
|
||||
Встановіть Istio без налаштування `sampling` всередині `defaultConfig`:
|
||||
|
||||
{{< text syntax=bash snip_id=install_without_sampling >}}
|
||||
$ cat <<EOF | istioctl install -y -f -
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
kind: IstioOperator
|
||||
spec:
|
||||
meshConfig:
|
||||
enableTracing: true
|
||||
extensionProviders:
|
||||
- name: otel-tracing
|
||||
opentelemetry:
|
||||
port: 4317
|
||||
service: opentelemetry-collector.observability.svc.cluster.local
|
||||
resource_detectors:
|
||||
environment: {}
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
Потім увімкніть провайдера трейсингу через Telemetry API та задайте `randomSamplingPercentage`.
|
||||
|
||||
{{< text syntax=bash snip_id=enable_telemetry_with_sampling >}}
|
||||
$ kubectl apply -f - <<EOF
|
||||
apiVersion: telemetry.istio.io/v1
|
||||
kind: Telemetry
|
||||
metadata:
|
||||
name: otel-demo
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: otel-tracing
|
||||
randomSamplingPercentage: 10
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
### Власний OpenTelemetry Sampler {#custom-opentelemetry-sampler}
|
||||
|
||||
Специфікація OpenTelemetry визначає [Sampler API](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.31.0/specification/trace/sdk.md#sampler). Sampler API дозволяє створювати власний семплер, який може здійснювати більш інтелектуальні та ефективні рішення для вибірки, такі як [Probability Sampling](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.31.0/specification/trace/tracestate-probability-sampling.md).
|
||||
Специфікація OpenTelemetry визначає [Sampler API](https://opentelemetry.io/docs/specs/otel/trace/sdk/#sampler). Sampler API дозволяє створювати власний семплер, який може здійснювати більш інтелектуальні та ефективні рішення для вибірки, такі як [Probability Sampling](https://opentelemetry.io/docs/specs/otel/trace/tracestate-probability-sampling-experimental/).
|
||||
|
||||
Такі семплери потім можна поєднати з [`OpenTelemetryTracingProvider`](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider-OpenTelemetryTracingProvider).
|
||||
|
||||
|
|
@ -151,7 +147,7 @@ EOF
|
|||
|
||||
- [Dynatrace Sampler](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider-OpenTelemetryTracingProvider-DynatraceSampler)
|
||||
|
||||
Власні семплери налаштовуються через `Meshconfig`. Ось приклад конфігурації семплера Dynatrace:
|
||||
Власні семплери налаштовуються через `MeshConfig`. Ось приклад конфігурації семплера Dynatrace:
|
||||
|
||||
{{< text syntax=yaml snip_id=none >}}
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
|
|
@ -174,22 +170,26 @@ spec:
|
|||
cluster_id: 123
|
||||
{{< /text >}}
|
||||
|
||||
## Порядок пріоритету {#order-of-precedence}
|
||||
### Порядок пріоритету {#order-of-precedence}
|
||||
|
||||
З кількома способами налаштування вибірки важливо розуміти порядок пріоритету кожного методу.
|
||||
|
||||
При використанні випадкової вибірки за відсотком порядок пріоритету є:
|
||||
|
||||
`Telemetry API` > `Анотація Pod` > `MeshConfig`.
|
||||
<table><tr><td>Telemetry API > Анотація Pod > <code>MeshConfig</code> </td></tr></table>
|
||||
|
||||
Це означає, що якщо значення визначено в усіх з зазначених, вибирається значення з `Telemetry API`.
|
||||
Це означає, що якщо значення визначено в усіх з зазначених, вибирається значення з Telemetry API.
|
||||
|
||||
Коли налаштований власний OpenTelemetry семплер, порядок пріоритету є:
|
||||
|
||||
`Custom OTel Sampler` > (`Telemetry API` | `Анотація Pod` | `MeshConfig`)
|
||||
<table><tr><td>Custom OTel Sampler > (Telemetry API | Анотація Pod | <code>MeshConfig</code>)</td></tr></table>
|
||||
|
||||
Це означає, що якщо налаштований власний OpenTelemetry семплер, він перевизначить усі інші методи. Крім того, значення випадкової вибірки встановлено на `100` і не може бути змінене. Це важливо, оскільки власний семплер має отримувати 100% відрізків для правильного прийняття рішень.
|
||||
|
||||
## Розгортання OpenTelemetry Collector {#deploy-the-opentelemetry-collector}
|
||||
|
||||
{{< boilerplate start-otel-collector-service >}}
|
||||
|
||||
## Розгортання Bookinfo {#deploy-the-bookinfo-application}
|
||||
|
||||
Розгорніть [Bookinfo](/docs/examples/bookinfo/#deploying-the-application) як демонстраційний застосунок.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Apache SkyWalking
|
||||
description: Дізнайтеся, як налаштувати проксі для надсилання запитів трейсингу до Apache SkyWalking.
|
||||
weight: 10
|
||||
weight: 8
|
||||
keywords: [телеметрія,трейсинг,skywalking,спан,порт-форвардинг,telemetry,tracing,skywalking,span,port-forwarding]
|
||||
owner: istio/wg-policies-and-telemetry-maintainers
|
||||
test: yes
|
||||
|
|
@ -15,7 +15,7 @@ test: yes
|
|||
|
||||
## Налаштування трейсингу {#configure-tracing}
|
||||
|
||||
Якщо ви використовували CR `IstioOperator` для установки Istio, додайте наступне поле до вашої конфігурації:
|
||||
Якщо ви використовували конфігурацію `IstioOperator` для установки Istio, додайте наступне поле до вашої конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
|
|
@ -60,7 +60,7 @@ EOF
|
|||
|
||||
## Доступ до панелі управління {#accessing-the-dashboard}
|
||||
|
||||
[Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways) описує, як налаштувати доступ до надбудов Istio через шлюз.
|
||||
Завдання [Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways) описує, як налаштувати доступ до надбудов Istio через шлюз.
|
||||
|
||||
Для тестування (та тимчасового доступу) ви також можете використовувати порт-форвардинг. Використовуйте наступне, припускаючи, що ви розгорнули SkyWalking у просторі імен `istio-system`:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Налаштування трейсингу за допомогою Telemetry API
|
||||
description: Як налаштувати параметри трейсингу за допомогою Telemetry API.
|
||||
weight: 8
|
||||
weight: 2
|
||||
keywords: [телеметрія,трейсинг,telemetry,tracing]
|
||||
owner: istio/wg-policies-and-telemetry-maintainers
|
||||
test: yes
|
||||
|
|
@ -13,11 +13,15 @@ Istio надає можливість налаштувати розширені
|
|||
|
||||
1. Переконайтеся, що ваші застосунки пропагують заголовки трейсингу, як описано [тут](/docs/tasks/observability/distributed-tracing/overview/).
|
||||
|
||||
1. Дотримуйтесь посібника з установки трейсингу, розташованого в розділі [Інтеграції](/docs/ops/integrations/), залежно від вашого вибраного бекенду трейсингу, щоб встановити відповідний застосунок та налаштувати ваші проксі Istio для надсилання трейсів до розгортання трейсингу.
|
||||
1. Дотримуйтесь посібника з установки трейсингу, розташованого в розділі [Інтеграції](/docs/ops/integrations/), залежно від вашого вибраного бекенду трейсингу, щоб встановити відповідне програмне забезпечення та налаштувати постачальника розширення.
|
||||
|
||||
## Установка {#installation}
|
||||
|
||||
В цьому прикладі ми надсилаємо трейсинг до [`zipkin`](/docs/ops/integrations/zipkin/), тому переконайтеся, що він встановлений:
|
||||
В цьому прикладі ми надсилатимемо трейси до [`zipkin`](/docs/ops/integrations/zipkin/), тому переконайтеся, що він встановлений:
|
||||
|
||||
### Налаштування постачальника розширення {#configure-an-extension-provider}
|
||||
|
||||
Встановіть Istio з [постачальником розширення](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider), посилаючись на сервіс Zipkin:
|
||||
|
||||
{{< text bash >}}
|
||||
$ cat <<EOF > ./tracing.yaml
|
||||
|
|
@ -27,10 +31,9 @@ spec:
|
|||
meshConfig:
|
||||
enableTracing: true
|
||||
defaultConfig:
|
||||
tracing: {} # відключені параметри трейсингу MeshConfig
|
||||
tracing: {} # відключіть застарілі параметри трейсингу MeshConfig
|
||||
extensionProviders:
|
||||
# додати провайдера zipkin
|
||||
- name: zipkin
|
||||
- name: "zipkin"
|
||||
zipkin:
|
||||
service: zipkin.istio-system.svc.cluster.local
|
||||
port: 9411
|
||||
|
|
@ -38,7 +41,7 @@ EOF
|
|||
$ istioctl install -f ./tracing.yaml --skip-confirmation
|
||||
{{< /text >}}
|
||||
|
||||
### Увімкнення трейсингу для мережі {#enable-tracing-for-mesh}
|
||||
### Увімкнення трейсингу {#enable-tracing}
|
||||
|
||||
Увімкніть трейсинг, застосувавши наступну конфігурацію:
|
||||
|
||||
|
|
@ -51,11 +54,17 @@ metadata:
|
|||
namespace: istio-system
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
### Перевірка результатів {#verify-the-results}
|
||||
|
||||
Ви можете перевірити результати за допомогою [Zipkin UI](/docs/tasks/observability/distributed-tracing/zipkin/).
|
||||
|
||||
## Налаштування {#customization}
|
||||
|
||||
## Налаштування відбору трейсів {#customizing-trace-sampling}
|
||||
|
||||
Параметр швидкості відбору можна використовувати для контролю відсотка запитів, які надсилаються до вашої системи трейсингу. Це потрібно налаштувати залежно від вашого трафіку в мережі та обсягу даних трейсингу, які ви хочете збирати. Стандартно швидкість відбору становить 1%.
|
||||
|
|
@ -69,13 +78,13 @@ metadata:
|
|||
namespace: istio-system
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
randomSamplingPercentage: 100.00
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
randomSamplingPercentage: 100.00
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
## Налаштування теґів трейсингу {#customizing-tracing-tags}
|
||||
### Налаштування теґів трейсингу {#customizing-tracing-tags}
|
||||
|
||||
Власні теґи можуть бути додані до відрізків на основі літералів, змінних середовища та заголовків запитів клієнтів для надання додаткової інформації у відрізках, специфічних для вашого середовища.
|
||||
|
||||
|
|
@ -94,9 +103,9 @@ EOF
|
|||
name: mesh-default
|
||||
namespace: istio-system
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
randomSamplingPercentage: 100.00
|
||||
customTags:
|
||||
"provider":
|
||||
|
|
@ -115,7 +124,7 @@ EOF
|
|||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
- name: "zipkin"
|
||||
randomSamplingPercentage: 100.00
|
||||
customTags:
|
||||
"cluster_id":
|
||||
|
|
@ -139,7 +148,7 @@ EOF
|
|||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
- name: "zipkin"
|
||||
randomSamplingPercentage: 100.00
|
||||
customTags:
|
||||
my_tag_header:
|
||||
|
|
@ -148,7 +157,7 @@ EOF
|
|||
defaultValue: <VALUE> # необов'язково
|
||||
{{< /text >}}
|
||||
|
||||
## Налаштування довжини теґів трейсингу {#customizing-tracing-tag-length}
|
||||
### Налаштування довжини теґів трейсингу {#customizing-tracing-tag-length}
|
||||
|
||||
Стандартно максимальна довжина для шляху запиту, включеного в теґ відрізку `HttpUrl`, становить 256. Щоб змінити цю максимальну довжину, додайте наступне до вашого файлу `tracing.yaml`.
|
||||
|
||||
|
|
@ -159,16 +168,11 @@ spec:
|
|||
meshConfig:
|
||||
enableTracing: true
|
||||
defaultConfig:
|
||||
tracing: {} # відключені параметри трейсингу через `MeshConfig`
|
||||
tracing: {} # відключіть застарілі параметри трейсингу через `MeshConfig`
|
||||
extensionProviders:
|
||||
# додати провайдера zipkin
|
||||
- name: zipkin
|
||||
- name: "zipkin"
|
||||
zipkin:
|
||||
service: zipkin.istio-system.svc.cluster.local
|
||||
port: 9411
|
||||
maxTagLength: <VALUE>
|
||||
{{< /text >}}
|
||||
|
||||
## Перевірка результатів {#verify-the-results}
|
||||
|
||||
Ви можете перевірити результати за допомогою [Zipkin UI](/docs/tasks/observability/distributed-tracing/zipkin/).
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Zipkin
|
||||
description: Дізнайтеся, як налаштувати проксі-сервери для надсилання запитів на трейсинг до Zipkin.
|
||||
weight: 50
|
||||
weight: 7
|
||||
keywords: [telemetry,tracing,zipkin,span,port-forwarding]
|
||||
aliases:
|
||||
- /uk/docs/tasks/zipkin-tracing.html
|
||||
|
|
@ -19,13 +19,53 @@ test: yes
|
|||
|
||||
1. Дотримуйтесь інструкцій у розділі [Встановлення Zipkin](/docs/ops/integrations/zipkin/#installation) для розгортання Zipkin у вашому кластері.
|
||||
|
||||
2. Коли ви увімкнете трейсинг, ви зможете встановити коефіцієнт відбору, який Istio використовує для трейсингу. Використовуйте параметр `meshConfig.defaultConfig.tracing.sampling` під час встановлення, щоб [встановити коефіцієнт відбору](/docs/tasks/observability/distributed-tracing/mesh-and-proxy-config/#customizing-trace-sampling). Стандартне значення для коефіцієнта відбору дорвінює 1%.
|
||||
1. Розгорніть зразок застосунку [Bookinfo](/docs/examples/bookinfo/#deploying-the-application).
|
||||
|
||||
3. Розгорніть зразок застосунку [Bookinfo](/docs/examples/bookinfo/#deploying-the-application).
|
||||
## Налаштування Istio для розподіленого трейсингу {#configure-istio-for-distributed-tracing}
|
||||
|
||||
### Налаштування постачальника розширень {#configure-an-extension-provider}
|
||||
|
||||
Встановіть Istio з [постачальником розширень](/docs/reference/config/istio.mesh.v1alpha1/#MeshConfig-ExtensionProvider) посилаючись на сервіс Zipkin:
|
||||
|
||||
{{< text bash >}}
|
||||
$ cat <<EOF > ./tracing.yaml
|
||||
apiVersion: install.istio.io/v1alpha1
|
||||
kind: IstioOperator
|
||||
spec:
|
||||
meshConfig:
|
||||
enableTracing: true
|
||||
defaultConfig:
|
||||
tracing: {} # відключіть застарілі параметри трейсингу MeshConfig
|
||||
extensionProviders:
|
||||
- name: zipkin
|
||||
zipkin:
|
||||
address: zipkin.istio-system.svc.cluster.local
|
||||
port: 9411
|
||||
EOF
|
||||
$ istioctl install -f ./tracing.yaml --skip-confirmation
|
||||
{{< /text >}}
|
||||
|
||||
### Увімкнення трейсингу {#enable-tracing}
|
||||
|
||||
Увімкніть трейсинг, застосувавши наступну конфігурацію:
|
||||
|
||||
{{< text bash >}}
|
||||
$ kubectl apply -f - <<EOF
|
||||
apiVersion: telemetry.istio.io/v1
|
||||
kind: Telemetry
|
||||
metadata:
|
||||
name: mesh-default
|
||||
namespace: istio-system
|
||||
spec:
|
||||
tracing:
|
||||
- providers:
|
||||
- name: "zipkin"
|
||||
EOF
|
||||
{{< /text >}}
|
||||
|
||||
## Доступ до інфопанелі (дашбоарду) {#accessing-the-dashboard}
|
||||
|
||||
Детальніше про конфігурацію доступу до надбудов Istio через шлюз можна прочитати в розділі [Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways).
|
||||
Детальніше про конфігурацію доступу до надбудов Istio через шлюз можна прочитати в завданні [Віддалений доступ до надбудов телеметрії](/docs/tasks/observability/gateways).
|
||||
|
||||
Для тестування (та тимчасового доступу) ви також можете використовувати перенаправлення портів. Використовуйте наступну команду, припускаючи, що ви розгорнули Zipkin у просторі імен `istio-system`:
|
||||
|
||||
|
|
|
|||
|
|
@ -44,7 +44,7 @@ spec:
|
|||
|
||||
### Використання конфігурації Mesh {#using-mesh-config}
|
||||
|
||||
Якщо ви використовували CR `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
Якщо ви використовували конфігурацію `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
spec:
|
||||
|
|
|
|||
|
|
@ -83,7 +83,7 @@ EOF
|
|||
|
||||
### Використання Mesh Config {#using-mesh-config}
|
||||
|
||||
Якщо ви використовували CR `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
Якщо ви використовували конфігурацію `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
spec:
|
||||
|
|
|
|||
|
|
@ -85,20 +85,19 @@ has(request.host) ? request.host : "unknown"
|
|||
|
||||
Istio відкриває всі стандартні [атрибути Envoy](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/advanced/attributes). Метадані peer доступні як атрибути `upstream_peer` для виходу і `downstream_peer` для входу з наступними полями:
|
||||
|
||||
|Поле | Тип | Значення |
|
||||
|---|---|---|
|
||||
| `name` | `string` | Назва poaʼа. |
|
||||
| `namespace` | `string` | Простір імен, у якому працює pod. |
|
||||
| `labels` | `map` | Мітки навантаження. |
|
||||
| `owner` | `string` | Власник навантаження. |
|
||||
| `workload_name` | `string` | Назва навантаження. |
|
||||
| `platform_metadata` | `map` | Метадані платформи з префіксованими ключами. |
|
||||
| `istio_version` | `string` | Ідентифікатор версії для проксі. |
|
||||
| `mesh_id` | `string` | Унікальний ідентифікатор для мережі. |
|
||||
| `app_containers` | `list<string>` | Список коротких імен для контейнерів застосунку. |
|
||||
| `cluster_id` | `string` | Ідентифікатор кластера, до якого належить це навантаження. |
|
||||
|Поле | Тип | Значення |
|
||||
|-------------|----------|-------------------------------------------------------------------|
|
||||
| `app` | `string` | Назва застосунку. |
|
||||
| `version` | `string` | Версія застосунку. |
|
||||
| `service` | `string` | Екземпляр Service. |
|
||||
| `revision` | `string` | Версія Service. |
|
||||
| `name` | `string` | Імʼя podʼа. |
|
||||
| `namespace` | `string` | Простір імен, в якому запущено pod. |
|
||||
| `type` | `string` | Тип робочого навантаження. |
|
||||
| `workload` | `string` | Назва робочого навантаження. |
|
||||
| `cluster` | `string` | Ідентифікатор кластера, до якого належить це робоче навантаження. |
|
||||
|
||||
Наприклад, вираз для мітки peer `app`, що використовується у вихідній конфігурації, — це `upstream_peer.labels['app'].value`.
|
||||
Наприклад, вираз для мітки peer `app`, що використовується у вихідній конфігурації, — це `filter_state.downstream_peer.app` або `filter_state.upstream_peer.app`.
|
||||
|
||||
## Очищення {#cleanup}
|
||||
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@ Istio має [опцію встановлення](/docs/reference/config/istio.
|
|||
|
||||
1. Змініть опцію `meshConfig.outboundTrafficPolicy.mode` на `REGISTRY_ONLY`.
|
||||
|
||||
Якщо ви використовували CR `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
Якщо ви використовували конфігурацію `IstioOperator` для встановлення Istio, додайте наступне поле до вашої конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
spec:
|
||||
|
|
|
|||
|
|
@ -74,7 +74,7 @@ Egress gateways автоматично [розгортаються](/docs/tasks/
|
|||
|
||||
Якщо жодного з podʼів не було повернено, розгорніть Istio egress gateway, виконавши наступний крок.
|
||||
|
||||
2. Якщо ви використовували CR `IstioOperator` для встановлення Istio, додайте наступні поля до конфігурації:
|
||||
2. Якщо ви використовували конфігурацію `IstioOperator` для встановлення Istio, додайте наступні поля до конфігурації:
|
||||
|
||||
{{< text yaml >}}
|
||||
spec:
|
||||
|
|
|
|||
Loading…
Reference in New Issue