Автоматична інструменталізація Lambda
Спільнота OpenTelemetry надає окремі шари інструменталізації Lambda для наступних мов:
- Java
- JavaScript
- Python
- Ruby
Ці шари можна додати до вашої Lambda за допомогою порталу AWS для автоматичної інструменталізації вашого застосунку. Ці шари не включають Collector, який є обовʼязковим доповненням, якщо ви не налаштуєте зовнішній екземпляр Collector для надсилання ваших даних.
Додайте ARN шару OTel Collector Lambda
Дивіться керівництво по шару Collector Lambda, щоб додати шар до вашого застосунку та налаштувати Collector. Ми рекомендуємо додати це спочатку.
Вимоги до мови
Шар Lambda підтримує середовища виконання Java 8, 11 та 17 (Corretto). Для отримання додаткової інформації про підтримувані версії Java дивіться документацію OpenTelemetry Java.
Примітка: Агент автоматичної інструменталізації Java знаходиться в шарі Lambda — Автоматична інструменталізація має значний вплив на час запуску в AWS Lambda, і вам зазвичай потрібно використовувати це разом з виділеним паралелізмом та запитами на розігрів, щоб обслуговувати ваші промислові запити без виклику тайм-аутів на початкових запитах під час ініціалізації.
Стандартно агент OTel Java в шарі спробує автоматично інструментувати весь код у вашому застосунку. Це може негативно вплинути на час холодного запуску Lambda.
Ми рекомендуємо вмикати автоматичну інструменталізацію лише для бібліотек/фреймворків, які використовуються вашим застосунком.
Щоб увімкнути лише конкретні інструменталізації, ви можете використовувати наступні змінні середовища:
OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED: якщо встановлено false, вимикає автоматичну інструменталізацію в шарі, вимагаючи увімкнення кожної інструменталізації окремо.OTEL_INSTRUMENTATION_<NAME>_ENABLED: встановіть true, щоб увімкнути автоматичну інструменталізацію для конкретної бібліотеки або фреймворку. Замініть<NAME>на інструменталізацію, яку ви хочете увімкнути. Для списку доступних інструменталізацій дивіться Придушення конкретної інструменталізації агента.
Наприклад, щоб увімкнути автоматичну інструменталізацію лише для Lambda та AWS SDK, ви повинні встановити наступні змінні середовища:
OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED=false
OTEL_INSTRUMENTATION_AWS_LAMBDA_ENABLED=true
OTEL_INSTRUMENTATION_AWS_SDK_ENABLED=true
Шар Lambda підтримує середовища виконання Node.js v18+. Для отримання додаткової інформації про підтримувані версії JavaScript та Node.js дивіться документацію OpenTelemetry JavaScript.
Шар Lambda підтримує середовища виконання Python 3.9+. Для отримання додаткової інформації про підтримувані версії Python дивіться документацію OpenTelemetry Python та пакет на PyPi.
Шар Lambda підтримує середовища виконання Ruby 3.2 та 3.3. Для отримання додаткової інформації про підтримувані версії OpenTelemetry Ruby SDK та API дивіться документацію OpenTelemetry Ruby та пакет на RubyGem.
Налаштуйте AWS_LAMBDA_EXEC_WRAPPER
Змініть точку входу вашого застосунку, встановивши AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler для Node.js, Java, Ruby чи Python. Ця скрипт-обгортка викликатиме ваш застосунок Lambda з застосованою автоматичною інструменталізацією.
Додайте ARN шару інструменталізації Lambda
Щоб увімкнути автоматичну інструменталізацію OTel у вашій функції Lambda, вам потрібно додати та налаштувати шари інструменталізації та Collector, а потім увімкнути трасування.
- Відкрийте функцію Lambda, яку ви маєте намір інструментувати, в консолі AWS.
- У розділі Layers in Designer виберіть Add a layer.
- У розділі specify an ARN вставте ARN шару, а потім виберіть Add.
Знайдіть найновіший реліз шару інструменталізації для вашої мови та використовуйте його ARN після зміни теґу <region> на регіон, в якому знаходиться ваша Lambda.
Примітка: Шари Lambda є регіоналізованим ресурсом, тобто вони можуть використовуватися лише в регіоні, в якому вони опубліковані. Переконайтеся, що використовуєте шар в тому ж регіоні, що і ваші функції Lambda. Спільнота публікує шари у всіх доступних регіонах.
Налаштуйте експортери SDK
Стандартні експортери, які використовуються шарами Lambda, працюватимуть без змін, якщо є вбудований Collector з приймачами gRPC / HTTP. Змінні середовища не потрібно оновлювати. Однак, існують різні рівні підтримки протоколів та стандартних значень для кожної мови, які задокументовані нижче.
OTEL_EXPORTER_OTLP_PROTOCOL=grpc підтримує: grpc, http/protobuf та http/json OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
Змінна середовища OTEL_EXPORTER_OTLP_PROTOCOL не підтримується. Жорстко закодований експортер використовує протокол http/protobuf OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf підтримує: http/protobuf та http/json OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf підтримує: http/protobuf OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
Опублікуйте вашу Lambda
Опублікуйте нову версію вашої Lambda, щоб розгорнути нові зміни та інструменталізацію.
Відгук
Чи це було корисним?
Дякуємо. Ми цінуємо ваші відгуки!
Будь ласка, дайте нам знати як ми можемо покращити цю сторінку. Ми цінуємо ваші відгуки!