StatefulActor теперь обладает встроенной наблюдаемостью. Журналы выполнения, журналы вызовов и метрики доступны непосредственно через CLI telnyx-edge, включая потоковую передачу журналов в реальном времени, поэтому вы можете отлаживать акторы без настройки отдельного стека мониторинга.
Что нового
- Журналы выполнения: вывод console.log и console.error, создаваемый методами вашего актора, извлекается с помощью telnyx-edge actors logs <type> --type runtime. Журналы выполнения — это вывод на уровне типа, они не привязаны к конкретному ID вызова.
- Журналы вызовов: одна запись на каждый вызов метода, создаваемая платформой, включая экземпляр, метод, результат и длительность. Фильтрация по конкретному экземпляру актора выполняется с помощью --instance <id>. Извлекаются с помощью telnyx-edge actors logs <type> --type invocations.
- Метрики: количество запросов, показатели успешности и ошибок, задержка, объем байтов запросов и ответов, использование CPU, памяти и размер сохраненного состояния. Извлекаются с помощью telnyx-edge actors metrics <type>.
- Потоковая передача в реальном времени: добавьте --tail к команде telnyx-edge actors logs <type>, чтобы оставаться подключенным и получать новые строки журналов по мере их поступления. Это работает как для журналов выполнения, так и для журналов вызовов, с фильтрацией --type для обоих типов журналов и фильтрацией --instance <id> для журналов вызовов. Например: telnyx-edge actors logs my-actor --tail --type invocations --instance alice. Для использования --tail требуется CLI версии 0.5.10 или новее.
По умолчанию обе команды считывают ограниченное окно исторических данных, которое можно настроить с помощью --since. Режим истории завершается после вывода данных, в то время как --tail оставляет команду logs активной и транслирует новые строки по мере их появления. Активные сессии прерываются примерно каждые 10 минут и автоматически переподключаются, однако строки, созданные в этот промежуток, будут потеряны. Для работы журналов и метрик в режиме истории требуется CLI версии 0.5.8 или новее. Для --tail требуется версия 0.5.10 или новее.
Для отладки проблемы найдите неудачные вызовы методов в журналах вызовов, определите, какой экземпляр актора и метод были задействованы, изучите ближайший вывод среды выполнения и проверьте метрики на наличие скачков задержки, нагрузки на память или изменений в сохраненном состоянии. Чтобы обнаружить проблему в момент её возникновения, транслируйте оба типа журналов в реальном времени с помощью --tail.
Почему это важно
Когда StatefulActor представляет собой корзину покупок, сессию, игру, устройство или другую сущность с состоянием, вам необходимо отлаживать его в рабочей среде. В стеке, состоящем из решений разных поставщиков, наблюдаемость сама по себе становится проблемой интеграции. Вы запускаете актор на одной платформе, отправляете журналы на другую, передаете метрики на третью и пытаетесь сопоставить данные между панелями мониторинга, которые изначально не были предназначены для взаимодействия друг с другом. Стек мониторинга превращается в систему, которую вы строите и поддерживаете параллельно с основным приложением.
На Telnyx платформа, на которой работает актор, сама создает журналы и метрики, поскольку именно она выполняет код. Вывод среды выполнения, записи вызовов на уровне методов и метрики ресурсов доступны через тот же CLI, который вы используете для управления своими Stateful Actors. Вы получаете полезную наблюдаемость «из коробки», без необходимости интегрировать отдельный стек мониторинга только для того, чтобы начать отладку.
С чего начать
- Обновите CLI до версии 0.5.10 или новее: npm i -g @telnyx/edge.
- Получите журналы выполнения для типа: telnyx-edge actors logs my-actor --type runtime.
- Получите журналы вызовов, чтобы увидеть время выполнения методов и результаты: telnyx-edge actors logs my-actor --type invocations.
- Получите метрики по количеству запросов, задержке, CPU, памяти и размеру сохраненного состояния: telnyx-edge actors metrics my-actor.
- Транслируйте журналы в реальном времени по мере их поступления: telnyx-edge actors logs my-actor --tail.
