Известные ограничения для поддержки Go - История изменений

IKuznetsov в 16:20, 8 января 2025

2025-01-08T16:20:43Z

← Предыдущая версия		Версия от 16:20, 8 января 2025
Строка 1:		Строка 1:
	'''''[[Поддержка технологий]] / Программное обеспечение / [[Go]] / Служба поддержки / Известные ограничения для поддержки Go'''''		'''''[[Поддержка технологий]] / [https://docs.expert-apm.ru/index.php/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0_%D1%82%D0%B5%D1%85%D0%BD%D0%BE%D0%BB%D0%BE%D0%B3%D0%B8%D0%B9#:~:text=%D0%9F%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%BD%D0%BE%D0%B5%20%D0%BE%D0%B1%D0%B5%D1%81%D0%BF%D0%B5%D1%87%D0%B5%D0%BD%D0%B8%D0%B5 Программное обеспечение] / [[Go]] / Служба поддержки / Известные ограничения для поддержки Go'''''

	Прежде чем начать использовать мониторинг приложений Go, убедитесь, что вы знаете об известных ограничениях.		Прежде чем начать использовать мониторинг приложений Go, убедитесь, что вы знаете об известных ограничениях.
Строка 25:		Строка 25:
	Обходной путь		Обходной путь

	Создайте приложение Go как динамически связанный исполняемый файл (который динамически связывается с libc). Это гарантирует, что и приложение Go, и ~~ЕдиныАгент~~ используют одну и ту же версию <code>libc</code>, доступную на хосте.		Создайте приложение Go как динамически связанный исполняемый файл (который динамически связывается с libc). Это гарантирует, что и приложение Go, и ЕдиныйАгент используют одну и ту же версию <code>libc</code>, доступную на хосте.

	==== Для статического мониторинга Go требуется возможность <code>SYS_PTRACE</code> в контейнерах Docker. ====		==== Для статического мониторинга Go требуется возможность <code>SYS_PTRACE</code> в контейнерах Docker. ====

IKuznetsov в 12:48, 8 ноября 2024

2024-11-08T12:48:07Z

← Предыдущая версия		Версия от 12:48, 8 ноября 2024
Строка 15:		Строка 15:

	== Поддержка статического мониторинга ==		== Поддержка статического мониторинга ==
	~~Ключ-Астром~~ ЕдиныйАгент поддерживает статический мониторинг приложений Go, начиная с ЕдиногоАгента версии 1.203. Инструкции по включению этой функции см. в разделе Включение статического мониторинга Go.		АппОптима ЕдиныйАгент поддерживает статический мониторинг приложений Go, начиная с ЕдиногоАгента версии 1.203. Инструкции по включению этой функции см. в разделе Включение статического мониторинга Go.

	=== Ограничения ===		=== Ограничения ===
Строка 82:		Строка 82:

	== Поддержка musl libc ==		== Поддержка musl libc ==
	Библиотека musl libc является заменой библиотеки glibc. ~~Ключ-Астром~~ поддерживает приложения Go на основе musl, например, созданные на Alpine Linux.		Библиотека musl libc является заменой библиотеки glibc. АппОптима поддерживает приложения Go на основе musl, например, созданные на Alpine Linux.

	Существует одно дополнительное требование для создания динамически подключаемого двоичного файла приложения. Вы должны использовать цепочку инструментов Go для alpine (golang:<версия>-alpine) и добавить <code>-ldflags '-linkmode external'</code> в командную строку сборки, чтобы принудительно использовать системный компоновщик. Это не требуется для статически связанных приложений Go, отслеживаемых статическим мониторингом Go.		Существует одно дополнительное требование для создания динамически подключаемого двоичного файла приложения. Вы должны использовать цепочку инструментов Go для alpine (golang:<версия>-alpine) и добавить <code>-ldflags '-linkmode external'</code> в командную строку сборки, чтобы принудительно использовать системный компоновщик. Это не требуется для статически связанных приложений Go, отслеживаемых статическим мониторингом Go.
Строка 89:		Строка 89:
	Хотя musl libc очень похожа на функциональность glibc, между ними есть тонкие поведенческие различия. Более того, Go официально не поддерживает набор инструментов Go на основе musl, а это означает, что бинарные файлы набора инструментов Go нельзя загрузить с веб-сайта golang.org.		Хотя musl libc очень похожа на функциональность glibc, между ними есть тонкие поведенческие различия. Более того, Go официально не поддерживает набор инструментов Go на основе musl, а это означает, что бинарные файлы набора инструментов Go нельзя загрузить с веб-сайта golang.org.

	Кроме того, существует серьезная проблема с тем, как Go использует musl libc. Это ограничивает степень, в которой ~~Ключ-Астром~~ может поддерживать приложения на основе musl. Цепочка инструментов Go включает внутренний компоновщик, который генерирует двоичные файлы приложений на основе musl, которые неправильно инициализируют musl libc при запуске приложения. Эта проблема не позволяет ~~Ключ-Астром~~ отслеживать эти приложения. В таком случае на соответствующей странице обработки заявки отображается следующее сообщение:		Кроме того, существует серьезная проблема с тем, как Go использует musl libc. Это ограничивает степень, в которой АппОптима может поддерживать приложения на основе musl. Цепочка инструментов Go включает внутренний компоновщик, который генерирует двоичные файлы приложений на основе musl, которые неправильно инициализируют musl libc при запуске приложения. Эта проблема не позволяет АппОптима отслеживать эти приложения. В таком случае на соответствующей странице обработки заявки отображается следующее сообщение:

	'''Активация глубокого мониторинга не удалась, мониторинг двоичных файлов Go musl, созданных с помощью внутреннего компоновщика Go, не поддерживается.'''		'''Активация глубокого мониторинга не удалась, мониторинг двоичных файлов Go musl, созданных с помощью внутреннего компоновщика Go, не поддерживается.'''

	Если вы используете системный компоновщик для создания двоичного файла приложения, он добавляет код запуска, который правильно инициализирует общие объекты. Кроме того, добавление <code>-ldflags 'linkmode external'</code> в командную строку сборки обеспечивает использование системного компоновщика. Полученный двоичный файл будет выполняться с правильно инициализированной libc, что позволит ~~Ключ-Астром~~ контролировать такое приложение.		Если вы используете системный компоновщик для создания двоичного файла приложения, он добавляет код запуска, который правильно инициализирует общие объекты. Кроме того, добавление <code>-ldflags 'linkmode external'</code> в командную строку сборки обеспечивает использование системного компоновщика. Полученный двоичный файл будет выполняться с правильно инициализированной libc, что позволит АппОптима контролировать такое приложение.

	=== Пример ===		=== Пример ===

ENetrebin в 12:08, 17 августа 2023

2023-08-17T12:08:24Z

← Предыдущая версия		Версия от 12:08, 17 августа 2023
Строка 1:		Строка 1:
			'''''[[Поддержка технологий]] / Программное обеспечение / [[Go]] / Служба поддержки / Известные ограничения для поддержки Go'''''

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

Lobanov в 07:27, 27 ноября 2022

2022-11-27T07:27:15Z

Внесённые изменения

IKolomin: Новая страница: «Прежде чем начать использовать мониторинг приложений Go, убедитесь, что вы знаете об изве...»

2021-12-02T06:57:43Z

Новая страница: «Прежде чем начать использовать мониторинг приложений Go, убедитесь, что вы знаете об изве...»

Новая страница

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

== Поддержка ограничена официальными стабильными выпусками Go ==
Поддержка Go ограничена официальными стабильными выпусками Go, скомпилированными с помощью инструментария Golang.

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

== Двоичные файлы приложения должны быть динамически связаны ==
Это ограничение применяется только к системам Linux и если статический мониторинг Go отключен.

Для полностью автоматического внедрения OneAgent требуются динамически связанные двоичные файлы приложений. Динамическое связывание применяется автоматически, когда приложение использует определенные стандартные пакеты библиотеки времени выполнения, например net / http.

Во всех остальных случаях вы можете принудительно установить динамическое связывание с помощью параметра командной строки -ldflags '-linkmode = external'. Обратите внимание, что отключение cgo, например, с использованием CGO_ENABLED = 0, не поддерживается, и OneAgent отклонит полученный двоичный файл приложения.