Устранение неполадок индексатора видео Azure AI с поддержкой Arc (предварительная версия)

Применяется к: Azure AI Video Indexer enabled by Azure Arc

Используйте следующую информацию для устранения неполадок с Индексатор видео ИИ Azure, поддерживаемым Arc.

Устранение общих ошибок

Если при использовании видеоиндексатора Azure AI, поддерживаемого с помощью Arc, возникает ошибка, проверьте следующие проблемы:

Портал Video Indexer не может получить доступ к расширению

Расширение было установлено успешно, но портал Индексатора видео не может получить доступ к расширению.

Существует множество причин, которые могут привести к взаимодействию между порталом Индексатора видео и расширением Индексатора видео, большинство из которых связаны с сетью. Например, проблемы с подключением и проблемы с проверкой сертификатов. Продолжайте чтение, чтобы определить, какая проблема может быть связана с доступом к расширению.

Воспроизведение имеет задержки буферизации

При потоковой трансляции из расширения Video Indexer воспроизведение задерживается из-за буферизации.

Это поведение является ожидаемым. Мультимедиа передаются из виртуальной машины с помощью потоковой передачи сети. Вы можете сделать одно из двух:

Закодируйте видео в MP4/H264 и AAC перед индексированием, чтобы обеспечить поддержку потоковой передачи сети на большинстве устройств или браузеров или ОС.
Реализуйте собственную конечную точку сервера потоковой передачи, которая выполняет кодирование заранее или использует JIT-кодирование.

Например, можно использовать ffmpeg и Shaka Packager для предварительной обработки кодирования и упаковки закодированного файла, позволяющего потоковую передачу протоколов HLS/DASH. При использовании этого метода потоковые файлы можно поместить в хранилище, а конечная точка потоковой передачи просто обслуживает файлы.

Устранение неполадок анализа в режиме реального времени

Используйте следующие разделы для диагностики проблем с индексатором видео Azure AI, работающим на Arc, в целях анализа видео в реальном времени.

Ошибка при подключении к расширению

Если вы получаете сообщение об ошибке Couldn't reach the Arc extension:

В строке URL-адреса браузера введите https://{cluster endpoint URL}/info
Выберите Дополнительно, а затем выберите Продолжить на {URL-адрес конечной точки кластера} (незащищенный).

Ошибка при подключении к камере

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

Обнаружение сбоев камеры

Вы можете отслеживать работоспособности камеры двумя способами:

Перейдите на вкладку "Управление камерами " — просмотрите состояние всех подключенных камер на панели мониторинга.

Используйте APIList-Cameras — получение подробных сведений о каждой камере программным способом, включая сообщения о состоянии и ошибках.
Ниже приведен пример выходных данных API с состоянием камеры:

{
"results": [
    {
        "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "name": "Factory",
        "description": "Factory",
        "status": "Offline",
        "errorInfo": {
            "errorType": "CAMERA_FATAL_ERROR",
            "errorMessage": "PGIE heartbeat not received, Live streaming heartbeat not received, Recording heartbeat not received"
        },
        "rtspUrl": "rtsp://media-server.video-indexer:8554/Factory",
        "presetId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "isPinned": true,
        "liveStreamingEnabled": true,
        "recordingEnabled": true,
        "recordingsRetentionInHours": 72,
        "insightsRetentionInHours": 4320,
        "deletionTime": null,
        "createTime": "2025-10-28T09:11:12.0933333+00:00",
        "lastUpdateTime": "2025-10-28T23:25:00.49+00:00"
    },
    {
        "id": "cccccccc-2222-3333-4444-dddddddddddd",
        "name": "Supermarket",
        "description": "Supermarket",
        "status": "Online",
        "rtspUrl": "rtsp://media-server.video-indexer:8554/Supermarket",
        "presetId": "67280024-1f2f-4034-b19b-bed53bd020cb",
        "isPinned": true,
        "liveStreamingEnabled": true,
        "recordingEnabled": false,
        "recordingsRetentionInHours": 72,
        "insightsRetentionInHours": 72,
        "deletionTime": null,
        "createTime": "2025-10-27T18:44:27.9033333+00:00",
        "lastUpdateTime": "2025-10-28T08:44:13.9766667+00:00"
    }
],
"nextPage": {
    "pageSize": 100,
    "skip": 0,
    "done": true,
    "totalCount": 2
 }
}

Ключевые поля для устранения неполадок

Для каждой неисправной камеры в следующих полях содержатся важные диагностические сведения:

status — указывает, работает ли камера. Состояние сбоя означает, что камера считается offline.
errorInfo— указывает тип ошибки и сообщение об ошибке, объясняющее причину отказа камеры.

Распространенные ситуации сбоя камеры

Используйте следующие разделы, чтобы устранить распространенные ситуации с сбоем камеры.

Недоступен RTSP URI

Сообщение об ошибке:RTSP uri is unreachable, camera not added
Причина: URL-адрес RTSP, указанный при создании камеры, не может быть достигнут.
Резолюция:
- Убедитесь, что поток RTSP является динамическим и доступным из сети.
- Так как URL-адреса RTSP не могут быть обновлены для существующих камер, удалите камеру и создайте новую с допустимым URL-адресом RTSP.

Пульс не получен

Сообщение об ошибке:PGIE/Recording/Live Streaming heartbeat not received
Причина: Видеокадры не обрабатывались более 2 минут. Это может произойти из-за следующего:
- Прерывание потока — камера перестала отправлять кадры, возможно, из-за нестабильности сети или сбоя камеры.
- Недостаточно места на общей папке или диске . Диск может быть заполнен, предотвращая создание новых файлов и обработку кадров.
- Внутренняя ошибка DeepStream — редка, но возможна из-за системных проблем.
Резолюция:
1. Убедитесь, что поток RTSP по-прежнему активен, а кадры передаются.
2. В журналах найдите сообщение gst-resource-error-quark; Could not open resource for writing.:
3. Затем проверьте поле свойств. Если он содержит No space left on device, сведения указывают на то, что общая папка или диск заполнены, и необходимо увеличить его объем. Это можно сделать с помощью следующей команды:
```
az k8s-extension update -n $EXTENSION_NAME -g $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --cluster-type $CLUSTER_TYPE --config storage.indexing.size=$STORAGE_SIZE --yes
```
4. Примените изменение конфигурации и восстановите его. Рассмотрим пример.
5. Отключите стриминг для затронутой камеры.
6. Повторно включите потоковую передачу.
7. Состояние камеры должно перейти из Офлайн > Обновление > Онлайн.
8. Если проблема сохраняется или повторяется часто, обратитесь в службу поддержки.

Внутренние ошибки

Сообщение об ошибке:An internal error occurred или другие неуказаемые ошибки.
Резолюция:
- Примените переключатель конфигурации, как описано ранее (отключите и повторно включите одну из функций: потоковая передача, запись или предустановка).
- Если проблема продолжается, обратитесь в службу поддержки.

Слишком много камер

Каждый тип GPU поддерживает другое количество камер. Если вы подключаете слишком много камер, GPU может не обрабатывать дополнительные потоки. Дополнительные сведения об ограничениях каждого GPU см. в разделе "Подключение камер к расширению VI".

Когда все камеры находятся в состоянии сбоя

Если все настроенные камеры отображают состояние сбоя:

Отключение потоковой передачи, записи и предустановок для всех камер. Данные действия переводят их состояние в автономное состояние без активной конфигурации.
Подождите не менее 5 минут.
Повторно при необходимости примените необходимую конфигурацию (включите потоковую передачу, запись или предустановки).
Если проблема повторяется после восстановления, обратитесь в службу поддержки и подготовьте журналы и сведения об ошибках.

Дополнительные рекомендации

Повторите предыдущие шаги.

Обнаружений нет спустя 5 минут

Если об обнаружениях не сообщается спустя более 5 минут, хотя объекты должны быть обнаружены, проблема часто связана с настройками или совместимостью GPU. Следующие сведения описывают наиболее распространенные причины и разрешения.

Возможные причины и разрешения

Неправильная предустановка

Причина: Предустановка может быть неправильно настроена или применена к неправильной камере. Общие проблемы:

Неправильное правописание в ключевых словах Custom Insights .
Применение предустановки к неправильной камере.

Резолюция:

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

Проблема совместимости GPU

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