Внедрение базовой панели мониторинга

На этой странице показано, как внедрить панель мониторинга в виде iframe во внешнее приложение. Зрители получают доступ к панели мониторинга по учетным данным Azure Databricks.

Сгенерировать код для внедрения

Чтобы создать код внедрения, который можно вставить во внешние приложения:

  1. Откройте опубликованную панель мониторинга, которую вы хотите внедрить. См. панели мониторинга авторов для изучения способов просмотра и доступа к панелям мониторинга в рабочей области.

  2. Щелкните "Поделиться " в правом верхнем углу.

  3. Нажмите кнопку "Внедрить панель мониторинга " в диалоговом окне "Общий доступ ".

  4. Откроется диалоговое окно Копировать код для вставки. Если существует список разрешенных доменов внедрения, перечислены домены. Нажмите кнопку , чтобы скопировать фрагмент кода.

    Диалоговое окно копирования кода внедрения показывает созданный код iframe и домены, в которые можно внедрить опубликованные панели мониторинга.

  5. Вставьте код внедрения в любую платформу или приложение, поддерживающую внедрение HTML и которая может отображать содержимое iframe. См. примеры .

Замечание

Примеры

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

Встраивание в Confluence

Созданному коду внедрения требуется небольшая корректировка в соответствии с требованиями Confluence. Чтобы внедрить панель мониторинга на страницу Confluence, выполните следующие действия.

  1. Измените код внедрения, чтобы включить только созданный URL-адрес, а не теги iframe или дополнительные значения разметки.

    Перед редактированием код внедрения включает HTML-тег iframe, ссылку на панель мониторинга для использования источника в iframe, и дополнительные параметры для высоты, ширины и границы, как показано в следующем примере кода. Для панели мониторинга пример заполнителей <databricks-instance-name> и <dashboard-and-workspace-ID> содержит фактические значения, связанные с рабочей областью и панелью мониторинга. Они приведены следующим образом:

    • Ваш <databricks-instance-name> — это первая часть URL-адреса при входе в рабочую область. См. сведения о получении идентификаторов для объектов рабочей области.
    • Это <dashboard-and-workspace-ID> последняя часть URL-адреса, указывающая на панель мониторинга. Выглядит примерно так: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447
    <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>

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

    https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>

  2. Вставьте элемент iframe на страницу. Сведения о том, как вставить iframe на страницу, см. в документации Confluence.

  3. Вставьте измененный URL встроенного элемента в текстовое поле URL и установите ширину на 100%.

  4. Настройте другие параметры в соответствии с вашими предпочтениями.

Панель мониторинга, внедренная в черновик страницы Confluence.

Встраивание в Salesforce Knowledge

Чтобы внедрить панель мониторинга на страницу знаний Salesforce, выполните следующие действия.

  1. Создайте страницу Visualforce. Инструкции см. в документации Salesforce.

  2. На экране "Изменить страницу " переместите курсор в редактор разметки Visualforce .

  3. Вставьте код внедрения, скопированный между двумя <apex:page></apex:page> тегами.

  4. Добавьте два тега абзаца (<p></p>) вокруг кода внедрения.

    В следующем примере заполнитель <dashboard-embed-code> используется для демонстрации того, как должна выглядеть разметка Visualforce. Экземпляр должен включать полный код вставки, скопированный вами.

    <apex:page >
<p><dashboard-embed-code></p>
</apex:page>

  5. Нажмите кнопку "Сохранить", чтобы сохранить изменения.

  6. Щелкните «Предварительный просмотр» и убедитесь, что панель отображается.

  7. Скопируйте URL-адрес предварительной версии компонента и создайте новый компонент iframe. Он должен выглядеть как следующий фрагмент кода. Заполнитель <your-salesforce-domain> должен быть заменен доменом Salesforce.

    <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>

  8. Перейдите на страницу "Знания", где вы хотите внедрить панель мониторинга.

  9. Нажмите «Изменить > Добавить компонент мультимедиа».

  10. Вставьте код iframe из предыдущего шага в текстовое поле встраивания.

Внедрение в SharePoint

Чтобы внедрить панель мониторинга в SharePoint, может потребоваться добавить URL-адрес Azure Databricks в список допустимых сайтов для внедренного содержимого на SharePoint. Инструкции см. в документации Microsoft. Затем выполните следующие действия.

  1. Перейдите на страницу SharePoint, где вы хотите разместить встроенную панель мониторинга.
  2. Добавьте элемент Embed на страницу.
  3. Вставьте полный код внедрения в адрес веб-сайта или поле кода внедрения в правой части экрана.
  4. Щелкните, чтобы подтвердить.

Панель мониторинга, встроенная в черновик страницы SharePoint

Внедрение одного мини-приложения

Чтобы внедрить одно мини-приложение из панели мониторинга, вам потребуется код внедрения панели мониторинга и уникальный идентификатор мини-приложения, который вы хотите отобразить.

Скопируйте уникальный идентификатор

Идентификатор одного мини-приложения — это сочетание значения страницы name и значения мини-приложения name , разделяемого тильдой (~).

Замечание

Ключ name отображается в сериализованном файле, который определяет панель мониторинга и недоступен из пользовательского интерфейса Azure Databricks. Он отличается от displayName значения, определяющего имя страницы, отображаемое в пользовательском интерфейсе. См. раздел "Изменить файл панели мониторинга".

Чтобы скопировать уникальный идентификатор, выполните следующие действия.

  1. Откройте опубликованную панель мониторинга в рабочей области Azure Databricks.

  2. Щелкните значок меню Kebab для мини-приложения, которое вы хотите внедрить.

  3. Нажмите кнопку "Просмотреть полный экран " или " Копировать ссылку на мини-приложение". URL-адрес содержит соответствующие значения страницы и мини-приложения name .

  4. Скопируйте параметр fullscreenWidget поиска и все после знака равенства (=).

    В следующем примере показана последняя часть URL-адреса для полноэкранного виджета.

    fullscreenWidget=53eadf26~3490f286

Измените сгенерированный код встраивания

  1. См. статью "Создание кода внедрения ", чтобы найти шаги по созданию кода внедрения панели мониторинга.
  2. Добавьте &fullscreenWidget=<ID> в URL-адрес вставки, заменив <ID> на объединённое <page-name>~<widget-name> значение.

Например, если базовый URL-адрес внедрения выглядит следующим образом:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

Обновленный URL-адрес внедрения с уникальным идентификатором должен выглядеть следующим образом:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

Просмотр встроенной панели мониторинга

Встроенные панели мониторинга обеспечивают безопасный способ доступа к данным панели мониторинга за пределами Azure Databricks. Применяются все существующие параметры общего доступа. Предназначенным пользователям должен быть предоставлен доступ к панели управления. См. сведения о том, кто может получить доступ к панели мониторинга? При доступе к встроенной панели управления пользователи получают запрос на вход в Azure Databricks, если они не активировали сеанс с последнего входа в ту же рабочую область.

Чтобы просмотреть внедренную панель мониторинга, выполните приведенные действия.

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

Спросите Джини во встроенных панелях

При просмотре встроенной панели мониторинга, опубликованной с соответствующим пространством Genie, зрители могут получить доступ к кнопке Ask Genie для изучения данных с помощью вопросов естественного языка.

Чтобы использовать Genie на встроенной панели мониторинга, выполните приведенные действия.

  1. Перейдите на страницу встроенной панели мониторинга.
  2. При необходимости войдите с помощью учетных данных Databricks.
  3. Щелкните Ask Genie в интерфейсе панели мониторинга.
  4. Введите вопросы естественного языка о данных панели мониторинга.

Genie использует те же разрешения и доступ к данным, что и опубликованная панель мониторинга. Дополнительные сведения о настройке и использовании Genie Spaces с панелями мониторинга см. в упомянутом разделе.

Замечание

Ask Genie доступен только в базовом встраивании. Ask Genie не поддерживается. Ask Genie недоступно во внешнем внедрении. Для внешних сценариев внедрения используйте API бесед Genie для интеграции возможностей запросов на естественном языке.

Пример экрана входа с встроенной панели мониторинга

Замечание

Если зарегистрированный пользователь, которому не предоставлен доступ к панели мониторинга, пытается просмотреть его, он получает сообщение об ошибке, которая говорит, что панель мониторинга недоступна. См. статью "Общий доступ к опубликованной панели мониторинга", чтобы узнать, как настроить параметры общего доступа.

Обновление встроенной панели мониторинга

Все зрители встроенной панели мониторинга могут вручную обновлять панели мониторинга по запросу. Вы также можете периодически настраивать расписание обновления панелей мониторинга.

См. статью "Управление запланированными обновлениями и подписками панели мониторинга".

Устранение неполадок с внедренными панелями мониторинга

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

Дальнейшие действия

  • Last updated on