Поделиться через


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Снимок экрана, показывающий ошибку: не удалось подключиться к расширению 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".

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

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

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

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

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

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

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

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

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

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

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

Резолюция:

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

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

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

Резолюция:

  1. Проверьте, какие графические процессоры доступны в кластере.
  2. Уточните, какой GPU используется расширением. Это можно сделать, выполнив следующие команды:
  3. Задайте правильный контекст с помощью следующих элементов: kubectl config use-context \$ctx
  4. Задайте пространство имен индексатора видео следующими параметрами: kubectl config set-context --current --namespace=video-indexer
  5. Получение всех pods с помощью следующей команды: kubectl get pods
  6. Скопируйте имя модуля pod deepstream и выполните следующую команду: kubectl exec -it \$pod -- /bin/bash
  7. Выполните следующую команду в контейнере DeepStream: nvidia-smi. Эта команда выводит сведения о GPU, включая тип GPU.
  8. Если между предполагаемым GPU и запущенным GPU имеется несоответствие, обновите расширение, чтобы использовать правильный GPU, с помощью следующей команды обновления расширения:
    az k8s-extension update --cluster-name "${CLUSTER_NAME}" -g "${RG}" --cluster-type connectedClusters -n ${EXTENSION_NAME} --config "ViAi.deepstream.nodeSelector.workload=deepstream"
    

Другие причины

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

  • Затронутые камеры
  • Предустановка конфигурации
  • Сведения о GPU
  • Журналы, охватывающие последние 10 минут до возникновения проблемы

Другие рекомендации

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

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