Введение
Это учебное руководство предназначено для администраторов или всех, кто хочет научиться управлять пользователями в Grafana. Вы добавите нескольких локальных пользователей, организуете их в команды и убедитесь, что они могут получать доступ только к тем ресурсам, которые им нужны.
Сценарий
Graphona, вымышленная компания, занимающаяся телемаркетингом, попросила вас настроить Grafana для своих команд.
В этом сценарии вы:
- Создадите пользователей и организуете их в команды.
- Настроите доступ к ресурсам для каждого пользователя и команды с помощью ролей и папок.
Предварительные требования
- Grafana 7.0 или новее; это учебное руководство протестировано с Grafana 8.5.
- Пользователь с ролью Admin или Server Admin.
Добавление пользователей
В Grafana всем пользователям предоставляется роль организации, которая определяет, к каким ресурсам они могут получить доступ.
В Grafana существует три типа ролей организации. Grafana Admin — это глобальная роль, её имеет пользователь admin по умолчанию.
- Grafana Admin — управление организациями, пользователями и просмотр серверных настроек.
- Organization Administrator — управление источниками данных, командами и пользователями в организации.
- Editor — создание и редактирование дашбордов.
- Viewer — просмотр дашбордов.
Note
Вы также можете настроить Grafana, разрешив анонимный доступ, чтобы дашборды были доступны даже тем, у кого нет учётной записи Grafana. Именно так Grafana Labs сделала https://play.grafana.org общедоступным.
Упражнение
Graphona попросила вас добавить группу ранних пользователей, которые работают в командах Marketing и Engineering. Им нужно иметь возможность редактировать дашборды своей команды, но они хотят иметь доступ на просмотр к дашбордам, принадлежащим другой команде.
Добавление пользователей
Повторите следующие действия для каждого сотрудника из таблицы выше, чтобы создать новые учётные записи пользователей:
- Войдите как пользователь с ролью Server Admin.
- В боковом меню нажмите значок Server Admin (щит).
- Выберите Users в раскрывающемся меню, затем нажмите New User.
- Введите Name, Email, Username и Password из таблицы выше.
- Нажмите кнопку Create User, чтобы создать учётную запись.
При создании пользователя ему по умолчанию предоставляется роль Viewer, что означает, что он не сможет вносить какие-либо изменения в ресурсы Grafana. Пока это нормально; вы предоставите больше прав пользователям, добавив их в команды на следующем шаге.
Назначение пользователей командам
Команды позволяют предоставлять разрешения группе пользователей, а не предоставлять разрешения отдельным пользователям по одному.
Команды полезны при адаптации новых коллег. Когда вы добавляете пользователя в команду, он получает доступ ко всем ресурсам, назначенным этой команде.
Упражнение
На этом шаге вы создадите две команды и назначите им пользователей.
Создание команды
Создайте команды Marketing и Engineering.
- В боковом меню наведите указатель мыши на значок Configuration (шестерёнка), а затем нажмите Teams.
- Нажмите New team.
- В поле Name введите название команды: Marketing или Engineering. Вводить электронную почту не нужно.
- Нажмите Create.
- Нажмите ссылку Teams в верхней части страницы, чтобы вернуться на страницу команд и создать вторую команду.
Добавление пользователя в команду
Повторите эти действия для каждого пользователя, чтобы назначить его в его команду. Обратитесь к таблице выше для назначений команд.
- Нажмите на название команды Marketing или Engineering, чтобы добавить участников в эту команду.
- Нажмите Add member.
- В поле Add team member нажмите стрелку раскрывающегося списка, чтобы выбрать пользователя, которого вы хотите добавить в команду.
- Нажмите Add to team.
Когда вы закончите, у вас будет две команды с двумя пользователями в каждой.
Управление доступом к ресурсам с помощью папок
Хорошая практика — использовать папки для организации коллекций связанных дашбордов. Вы можете назначать разрешения на уровне папки отдельным пользователям или командам.
Упражнение
Команда Marketing собирается использовать Grafana для аналитики, а команда Engineering хочет отслеживать приложение, которое она разрабатывает.
Вы создадите две папки, Analytics и Application, в которых каждая команда сможет добавлять свои собственные дашборды. Команды по-прежнему хотят иметь возможность просматривать дашборды друг друга.
Повторите следующие действия для каждой папки. Вы выполните все три шага для каждой папки, прежде чем перейти к следующей.
Добавление папки для каждой команды
- В боковом меню наведите курсор на значок Dashboards (четыре квадрата), а затем нажмите Browse.
- Чтобы создать папку, нажмите New Folder.
- В поле Name введите имя папки.
- Нажмите Create.
- Останьтесь в представлении папки и переходите к следующим разделам, чтобы изменить разрешения для этой папки.
Удаление роли Viewer из разрешений папки
По умолчанию при создании папки всем пользователям с ролью Viewer предоставляется разрешение на просмотр папки.
В этом примере Graphona хочет явно предоставить командам доступ к папкам. Чтобы это поддержать, вам нужно удалить роль Viewer из списка разрешений:
- Перейдите на вкладку Permissions.
- Удалите роль Viewer из списка, нажав красную кнопку справа.
- Останьтесь на вкладке разрешений и переходите к следующему разделу, чтобы предоставить разрешения на папку для каждой команды.
Предоставление разрешений на папку команде:
- Нажмите Add Permission.
- В диалоговом окне Add Permission For убедитесь, что в первом поле выбрано «Team».
- Во втором поле выберите команду, которой нужно предоставить доступ.
- В третьем поле выберите доступ, который вы хотите предоставить.
- Нажмите Save.
- Повторите для другой команды.
- Нажмите ссылку Dashboards в верхней части страницы, чтобы вернуться к списку дашбордов.
Когда вы закончите, у вас будет две пустые папки, содержимое которых смогут просматривать только участники команд Marketing или Engineering. Только участники команды Marketing смогут редактировать содержимое папки Analytics, только участники команды Engineering смогут редактировать содержимое папки Application.
Определение детализированных разрешений
Используя папки и команды, вы избегаете необходимости управлять разрешениями для отдельных пользователей.
Однако бывают случаи, когда вам нужно настроить разрешения на более детальном уровне. Для этих случаев Grafana позволяет переопределять разрешения для конкретных дашбордов.
Упражнение
Graphona наняла консультанта для помощи команде Marketing. Консультант должен иметь возможность доступа только к дашборду SEO в папке Analytics.
Добавление нового пользователя
- В боковом меню нажмите значок Server Admin (щит).
- На вкладке Users нажмите New user.
- В поле Name введите имя пользователя.
- В поле E-mail введите электронную почту пользователя.
- В поле Username введите имя пользователя, которое пользователь будет использовать для входа.
- В поле Password введите пароль. Пользователь может изменить свой пароль после входа.
- Нажмите Create user, чтобы создать учётную запись пользователя.
Создание дашборда
- В боковом меню нажмите значок Create (плюс), чтобы создать новый дашборд.
- В правом верхнем углу нажмите значок шестерёнки, чтобы перейти к Dashboard settings.
- В поле Name введите SEO.
- Нажмите Save Dashboard.
- Во всплывающем окне Save dashboard as… выберите папку Analytics из раскрывающегося списка и нажмите Save.
Предоставление пользователю разрешения на просмотр дашборда
- В правом верхнем углу вашего дашборда нажмите значок шестерёнки, чтобы перейти к Dashboard settings.
- Перейдите на вкладку Permissions и нажмите Add Permission.
- В диалоговом окне Add Permission For выберите User в первом поле.
- Во втором поле выберите пользователя, которому нужно предоставить доступ: Luc Masson.
- В третьем поле выберите View.
- Нажмите Save.
- Нажмите Save dashboard.
- Добавьте примечание о предоставлении Luc Masson разрешения Viewer для дашборда, а затем нажмите Save.
Вы создали нового пользователя и предоставили ему уникальные разрешения на просмотр одного дашборда в папке.
Проверка вашей работы
Вы можете повторить эти действия, чтобы войти как другие созданные вами пользователи и увидеть различия в ролях viewer и editor.
Для этого примера вы можете войти как пользователь luc.masson, чтобы увидеть, что он может получить доступ только к дашборду SEO.
- Нажмите кнопку профиля (аватар) в левом нижнем углу, выберите Sign out.
- Введите
luc.massonв качестве имени пользователя. - Введите пароль, который вы создали для Luc.
- Нажмите Log in.
- В боковом меню наведите курсор на значок Dashboards (четыре квадрата), а затем нажмите Browse.
- Вы заметите, что не увидите папку Analytics в представлении папок, потому что мы не предоставили Luc разрешение на папку.
- Нажмите значок списка (3 линии), чтобы увидеть список дашбордов.
- Нажмите на SEO dashboard; разрешений на редактирование быть не должно, так как мы назначили Luc роль viewer.
Резюме
В этом учебном руководстве вы настроили Grafana для организации:
- Вы добавили пользователей в свою организацию.
- Вы создали команды для управления разрешениями для групп пользователей.
- Вы настроили разрешения для папок и дашборда.