Распространение контекста

Мы рассматриваем некоторые продвинутые темы, связанные с GO2Sky.

Распространение контекста

Связи трассировки принадлежат ему с помощью распространения контекста, которое варьируется в зависимости от сценария.

В процессе

Мы используем пакет context для связывания промежутков. Корневой промежуток обычно выбирает context.Background(), а дочерние промежутки будут внедрять контекст, созданный его родителем.

// Создать новый контекст
entrySpan, entryCtx, err := tracer.CreateEntrySpan(context.Background(), ...)

// Некоторая операция
...

// Связать два промежутка путём внедрения контекста entrySpan в exitSpan
exitSpan, err := tracer.CreateExitSpan(entryCtx, ...)

Между процессами

Мы используем промежуток Entry для извлечения контекста из нижестоящего сервиса и используем промежуток Exit для внедрения контекста в вышестоящий сервис.

Промежутки Entry и Exit имеют смысл для анализа OAP, который генерирует топологическую карту и метрики сервисов.

// Извлечь контекст из заголовка HTTP-запроса sw8
span, ctx, err := tracer.CreateEntrySpan(r.Context(), "/api/login", func(key string) (string, error) {
        return r.Header.Get(key), nil
})

// Некоторая операция
...

// Внедрить контекст в заголовок HTTP-запроса sw8
span, err := tracer.CreateExitSpan(req.Context(), "/service/validate", "tomcat-service:8080", func(key, value string) error {
        req.Header.Set(key, value)
        return nil
})

Тег

Мы устанавливаем теги в промежуток, который хранится в бэкэнде, но некоторые теги имеют специальное назначение. Сервер OAP может использовать их для агрегирования метрик, генерации топологической карты и т. д.

Они определены как константы в корневом пакете с префиксом Tag.

Журнал x Контекст трассировки

Внедрите контекст трассировки в текст журнала. Механизм LAL (язык анализа журналов) SkyWalking может извлечь контекст из текста и соотнести трассировку и журналы.

// Получить данные контекста трассировки
import go2skylog "github.com/SkyAPM/go2sky/log"
logContext = go2skylog.FromContext(ctx)

// Построить строку данных контекста
// Ввести строку контекста в журнал
// Формат строки контекста: [$serviceName,$instanceName,$traceId,$traceSegmentId,$spanId]
contextString := logContext.String()

Плагины

Перейдите в репозиторий go2sky-plugins, чтобы увидеть все плагины, нажмите здесь.

Поддерживаемые переменные среды

Ниже приведён полный список поддерживаемых переменных среды, которые вы можете установить для настройки поведения агента. Пожалуйста, ознакомьтесь с описаниями того, чего они могут достичь.

CDS - Configuration Discovery Service

Configuration Discovery Service предоставляет динамическую конфигурацию для агента, определённую в gRPC и хранящуюся на бэкенде.

Доступные ключи и значения в Golang Agent.

Golang agent поддерживает следующие динамические конфигурации.

Process Status Hook

Эта функция используется в сотрудничестве с проектом skywalking-rover.

Когда go2sky остаётся в рабочем состоянии с бэкендом, он будет... Напишите файл с метаданными в локальный (временный каталог) одновременно, который описывает информацию о текущем процессе.

Ровер сканирует все процессы со стороны, выясняет, какой процесс содержит этот файл с метаданными. Наконец, ровер может собрать данные профилирования для этого процесса.

Файл с метаданными

Файл с метаданными используется для сохранения метаданных текущего процесса, он сохраняется по пути {TMPDIR}/apache_skywalking/process/{pid}/metadata.properties.

Также, когда go2sky поддерживает соединение с бэкэндом, время изменения и открытия файла с метаданными будет обновляться.

Пожалуйста, ознакомьтесь с официальной документацией ровера, чтобы получить больше информации.

Лицензия

Apache License 2.0. Смотрите файл LICENSE для получения подробной информации.