Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow Parcabreadcrumb arrow Устранение неполадок
Последнее обновление: апреля 10, 2026

Устранение неполадок источника данных Parca

Warning

Этот плагин устарел и будет получать только критически важные обновления безопасности. Поддержка прекратится 2 января 2027 года.

Эта страница содержит решения распространённых проблем, с которыми вы можете столкнуться при настройке или использовании источника данных Parca. Инструкции по настройке см. в разделе Настройка источника данных Parca.

Ошибки подключения

Эти ошибки возникают, когда Grafana не может достичь экземпляра Parca.

Ошибка «Save & test»

Симптомы:

  • Проверка источника данных завершается тайм-аутом или возвращает ошибку.
  • Невозможно подключиться к серверу Parca.

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

Причина Решение
Неверный URL Убедитесь, что URL указывает на вашу HTTP-конечную точку Parca (например, http://localhost:7070). Grafana подключается через gRPC-Web.
Parca не запущен Убедитесь, что ваш экземпляр Parca запущен и доступен с сервера Grafana.
Блокировка брандмауэром Проверьте, что правила брандмауэра разрешают исходящий трафик от Grafana к серверу Parca на настроенном порту.
Неправильная настройка TLS Если используется HTTPS, убедитесь, что сертификаты TLS правильно настроены как на Grafana, так и на Parca.

Когда подключение успешно, проверка работоспособности отображает «Data source is working». Проверка работоспособности запрашивает доступные типы профилей с сервера Parca, поэтому любая проблема со связностью или аутентификацией приводит к её сбою.

Ошибки «Connection refused» или тайм-аута

Симптомы:

  • Запросы завершаются сетевыми ошибками.
  • Периодические проблемы с подключением.

Решения:

  1. Проверьте сетевую связность от сервера Grafana до конечной точки Parca.
  2. Проверьте, что сервер Parca работоспособен и отвечает на запросы.
  3. Для Grafana Cloud настройте Private data source connect, если требуется доступ к приватному экземпляру Parca.

Ошибки запросов

Эти ошибки возникают при выполнении запросов к источнику данных Parca.

«Invalid report type» или «try updating Parca to v0.19+»

Симптомы:

  • Запросы завершаются ошибкой, содержащей «invalid report type».
  • Сообщение об ошибке предлагает обновить Parca до v0.19+.
  • Данные графа пламени не загружаются.

Решения:

  1. Обновите ваш сервер Parca до v0.19 или более поздней версии. Эта ошибка возникает потому, что старые версии Parca не поддерживают формат Arrow для графа пламени, который требуется Grafana.

Unknown report type returned from query. update parca

Симптомы:

  • Запросы профилей завершаются с этим точным сообщением об ошибке.
  • Запросы метрик при этом могут успешно выполняться.

Решения:

  1. Обновите ваш сервер Parca. Эта ошибка возникает, когда сервер Parca возвращает формат ответа, который Grafana не распознаёт. Обновление до последней версии Parca решает эту проблему.

«No data» или пустые результаты

Симптомы:

  • Запрос выполняется без ошибок, но не возвращает данные.
  • Граф пламени или панель метрик показывает «No data».

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

Причина Решение
Не выбран тип профиля Выберите тип профиля в раскрывающемся меню. Это поле обязательно — без него запросы молча возвращают пустые данные.
Диапазон времени не содержит данных Расширьте диапазон времени на дашборде или проверьте, что данные профилирования существуют за выбранный период.
Селектор меток слишком ограничительный Удалите или расширьте фильтры меток, чтобы убедиться, что подходящие профили существуют.
Ошибка синтаксиса в селекторе меток Убедитесь, что селектор меток использует допустимый синтаксис (например, {job="my-service"}). Поддерживаемые операторы см. в документации редактора запросов.
Parca не собирает цели Проверьте вашу конфигурацию Parca, чтобы убедиться, что цели собираются и профили накапливаются.

Проблемы редактора запросов

Эти проблемы связаны с интерфейсом редактора запросов.

Раскрывающийся список типов профилей пуст

Симптомы:

  • Селектор типа профиля не показывает параметров.
  • Текст кнопки гласит Select a profile type без чего-либо для выбора.

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

Причина Решение
Подключение к Parca не удалось Проверьте подключение источника данных с помощью Save & test в настройках источника данных.
В Parca нет собранных данных Проверьте, что Parca собирает цели и накопил данные профилей.
Ошибка сети или аутентификации Проверьте консоль разработчика браузера на предмет неудачных запросов к конечной точке ресурса profileTypes.

Отсутствует тип запроса «Both»

Симптомы:

  • В параметрах типа запроса отображаются только Metric и Profile.
  • Опция Both недоступна.

Решение:

Это ожидаемое поведение. Тип запроса Both доступен только в Explore. Панели дашбордов поддерживают только один тип визуализации, поэтому Grafana ограничивает параметры до Metric или Profile. Если запрос, установленный в Both в Explore, используется на дашборде, Grafana автоматически меняет его на Profile.

Подсказки автодополнения не появляются

Симптомы:

  • При вводе в селекторе меток не появляются подсказки имён или значений меток.
  • Автодополнение работает для одних меток, но не для других.

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

Причина Решение
Имена меток не загружены Подождите немного после открытия редактора запросов. Автодополнение загружает имена меток из Parca при инициализации.
Подключение к Parca не удалось Проверьте подключение источника данных. Автодополнение запрашивает конечные точки ресурсов labelNames и labelValues.
Позиция курсора не распознана Поместите курсор внутри фигурных скобок {} и после знака = для подсказок значений. Автодополнение срабатывает на определённых символах: {, ,, =, ~, ", пробел.

Проблемы с переменными шаблонов

Эти проблемы связаны с использованием переменных шаблонов с источником данных Parca.

Переменные не разрешаются в запросах

Симптомы:

  • Синтаксис переменной, такой как $variable, отображается буквально в результатах запроса, а не заменяется.
  • Запросы не возвращают данных при использовании переменных.

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

Причина Решение
Переменная используется в типе профиля Переменные шаблонов поддерживаются только в поле селектора меток. Раскрывающийся список типов профилей не поддерживает подстановку переменных.
Переменная не определена Убедитесь, что переменная существует в Dashboard options > Variables и имеет допустимые значения.
Неверный синтаксис переменной Используйте $variablename или ${variablename}. Убедитесь, что в имени переменной нет опечаток.

Невозможно использовать Parca для заполнения вариантов переменных

Симптомы:

  • При создании переменной типа query с источником данных Parca не возвращается никаких значений.

Решение:

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

Включение журналирования отладочного уровня

Чтобы получить подробную информацию об ошибках для устранения неполадок:

  1. Установите уровень журнала Grafana в debug в файле конфигурации:

    ini 
    [log]
level = debug

  2. Просмотрите журналы в /var/log/grafana/grafana.log (или в настроенном вами расположении журналов).

  3. Найдите записи, специфичные для Parca, которые содержат сведения о запросах и ответах. Распространённые сообщения журнала включают:

    • "Failed to get profile types" — не удалось загрузить типы профилей.
    • "Failed to get label names" — не удалось загрузить данные автодополнения меток.
    • "Failed to process query" — запрос к Parca вернул ошибку.
    • "Failed to unmarshall query" — не удалось разобрать JSON запроса.

  4. Сбросьте уровень журнала на info после устранения неполадок, чтобы избежать чрезмерного объёма журналов.

Получение дополнительной помощи

Если вы испробовали решения на этой странице, но проблемы сохраняются:

  1. Проверьте форумы сообщества Grafana на наличие похожих проблем.
  2. Просмотрите проблемы Grafana на GitHub на предмет известных ошибок, связанных с источником данных Parca.
  3. Обратитесь к документации Parca за рекомендациями, специфичными для службы.
  4. Свяжитесь с поддержкой Grafana, если вы пользователь Enterprise, Cloud Pro или Cloud Contracted.
  5. При сообщении о проблемах указывайте:
    • Версию Grafana
    • Версию сервера Parca
    • Сообщения об ошибках (удалите конфиденциальную информацию)
    • Шаги для воспроизведения
    • Соответствующую конфигурацию (удалите учётные данные)