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

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

Создание кода внедрения

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

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

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

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

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

   

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

Замечание

• Если диалоговое окно внедрения копирования содержит список разрешенных доменов, которые не включают целевой домен, администратор рабочей области может добавить его. См. статью "Управление панелью мониторинга" и доступом Genie.

• Встроенные панели мониторинга всегда отображаются с помощью светлого режима. См. раздел "Темный режим" не отображается.

Примеры

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

Внедрение в Confluence

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

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

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

   • Ваш <databricks-instance-name> URL-адрес является первой частью 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. Настройте другие параметры в соответствии с вашими предпочтениями.

Внедрение в 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. Инструкции см. в документации Майкрософт. Затем выполните следующие действия.

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

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

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

Копирование уникального идентификатора

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

Замечание

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

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

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

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

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 с панелями мониторинга см. в разделе Пространства Genie с досками.

Замечание

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

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

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

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

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

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

Дальнейшие шаги

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