RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 
Visa 
4274 3200 2453 6495 

Глава 16. Управление активами

В этой главе описываются страницы актива для хостов, агентов и кластеров NDB и описывается, как удалить информацию об активе из инвентаря MySQL Enterprise Monitor.

16.1. Представление Agents

Представление Agents позволяет вам рассмотреть всех агентов MySQL Enterprise Monitor, в настоящее время регистрируемых в MySQL Enterprise Service Manager.

Чтобы смотреть статус агента и конфигурацию, выберите Agents из раздела Configuration панели навигации.

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

Рис. 16.1. Представление Agents

Example of the Agents view.

Чтобы рассмотреть подробную информацию о конфигурации агента, выберите Details из информационного меню на правой стороне каждой строки.

Также возможно удалить агентов из инвентаря MySQL Enterprise Monitor, используя опцию Delete. См. раздел 16.4.

Рис. 16.2. Представление Agent Details

Example of the Agent details view.

Страница деталей агента разделена на следующие вкладки:

  • JVM: показывает детали виртуальной машины Java (JVM) агента.

  • MySQL Connections: (показано только, если агент контролирует сервер) перечисляет все подключения MySQL, в настоящее время проверяемые агентом, и их детали конфигурации. Такая информация как разрешены ли самоподписанные сертификаты, значения тайм-аутов, имена хоста и так далее.

  • MySQL Processes: (показано только, если агент контролирует сервер) перечисляет все проверенные процессы MySQL. Такая информация как аргументы, с которыми был начат процесс, ID процесса и так далее.

  • MySQL Instances: (показано только, если агент контролирует сервер) перечисляет все проверенные экзепляры MySQL. Такая информация как версия, статус, продолжительность работы и так далее.

  • OS: (показано только, если агент контролирует хост) подробная информация об операционной системе хоста, файловых системах, CPU и так далее.

16.2. Представление Hosts

Представление Hosts позволяет вам смотреть все в настоящее время проверяемые хосты и их конфигурацию.

Чтобы смотреть проверенные хосты, выберите Hosts из раздела Configuration панели навигации.

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

Рис. 16.3. Представление Hosts

Example of the hosts view.

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

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

Также возможно удалить хост, используя опцию Delete. См. раздел 16.4.

Рис. 16.4. Представление Host Details

Example of the Host details view.

Представление Hosts details содержит следующие вкладки:

  • Filesystems: перечисляет все файловые системы, доступные хосту. Информация включает используемые байты, неиспользованные байты, тип файловой системы и так далее.

  • Memory: перечисляет общую сумму доступной RAM и размер файла подкачки.

  • CPUs: перечисляет CPU, установленные на хосте. Информация включает количество ядер, размеры кэша, частоты и так далее.

  • MySQL Instances: перечисляет все проверенные экземпляры MySQL. Информация включает версию, статус, продолжительность работы и так далее.

  • Networks: перечисляет все сетевые интерфейсы на хосте, их типы, имена и так далее.

16.3. Представление NDB Clusters

Представление NDB Clusters позволяет вам рассмотреть все в настоящее время проверяемые кластеры, их членство и конфигурацию.

Чтобы рассмотреть проверенную кластерную конфигурацию и статус, выберите NDB Clusters в разделе Configuration панели навигации.

Рис. 16.5. Представление NDB Clusters

Example of the NDB Clusters view.

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

Чтобы рассмотреть подробную информацию о членстве кластера, выберите Details из меню на правой стороне каждой строки.

Также возможно удалить кластеры или узлы, применив опцию Delete, см. раздел 16.4.

Рис. 16.6. Представление NDB Clusters

Example of the NDB Clusters details view.

Представление деталей кластера показывает резюме узлов, организованных по типу узла. Каждая вкладка показывает текущее состояние каждого узла и подходящую конфигурационную информацию, в частности Bind Address, Process Name, Auto Reconnect и т.д.

Чтобы вникнуть в детали конфигурации каждого узла, выберите Details из меню справа в строке.

Представление деталей узла показывает всю доступную конфигурацию и статус для каждого проверенного узла.

16.4. Удаление активов

Эта секция описывает, как удалить активы и группы активов из инвентаря MySQL Enterprise Monitor.

Удаление активов из инвентаря не удаляет и не деинсталлирует активы из их установленных местоположений. Процесс удаляет удаляет всю запись об активе или группе активов из внутренней записи MySQL Enterprise Service Manager. Это позволяет вам удалить записи для кластеров, топологии, агентов, хостов и экземпляров, которые были проверены, но больше не используются.

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

Для получения дополнительной информации об инвентаре см. приложение B.

Для получения информации об удалении активов из командной строки посмотрите раздел 16.5.

Удаляемые типы активов следующие:

  • Экземпляры MySQL.

  • Агенты MySQL Enterprise Monitor.

  • Хосты.

  • Кластеры NDB: кластеры могут быть удалены целиком или можно удалить отдельные узлы, открыв представление NDB Cluster details и удалив узлы по одному.

    • Узлы NDB API.

      Удаление узла API NDB также удаляет сервер.

    • Узлы NDB Data.

    • Узлы управления NDB.

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

Невозможно удалить актив, если следующее верно:

  • Если у пользователя нет необходимых разрешений.

  • Невозможно удалить агент из инвентаря, если статус агента неизвестен, если агент работает, или если агент контролирует один или несколько серверов MySQL, которые не намечены для удаления в той же самой операции.

  • Невозможно удалить хост из инвентаря, если хост содержит агенты или экземпляры MySQL, которые также не намечены для удаления в той же самой операции.

Чтобы удалить актив, сделайте следующее:

  1. Откройте представление актива из меню Configuration.

  2. Чтобы удалить экземпляр MySQL из представления MySQL Instances, выберите Delete из меню экземпляра или выберите экземпляр (экземпляры) и нажмите кнопку Delete Instances.

    Чтобы удалить актив из определенных для актива представлений Agents, Hosts или NDB Clusters, выберите Delete из меню на строке каждого актива или выберите актив и нажмите кнопку Delete. Можно также выбрать все активы в представлении, используя кнопку Select All и удалить все, нажав кнопку Delete.

    Отобразится диалог Delete Confirmation.

    Рис. 16.7. Delete Confirmation для экземпляра MySQL

    Example of the delete confirmation dialog for a MySQL instance.

    Если невозможно удалить актив, предупреждение показано в столбце Deletable. Чтобы видеть больше информации о природе предупреждения, наведите курсор на предупреждение.

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

  4. Чтобы удалить активы, связанные с отобранным активом, выберите один из других типов в секции Advanced Options. Если выбор доступен, раздел Deletable Assets обновляется с деталями актива и удаляемое ли это.

    Например, при попытке удалить экземпляр MySQL и связанный хост:

    Рис. 16.8. Delete Confirmation для экземпляра MySQL и связанного хоста

    Example of the delete confirmation dialog for a MySQL instance
with related host selected.

    Связанному хосту также установили агента, который не связан с запросом удаления. Присутствие несвязанного агента предотвращает удаление экземпляра MySQL и связанного хоста. Кнопка Delete неактивна.

16.5. Удаление активов из командной строки

Эта секция описывает, как удалить информацию об активах и группы активов из инвентаря MySQL Enterprise Monitor, используя утилиту curl.

Удаление активов из инвентаря не удаляет и не деинсталлирует активы из их установленных местоположений. Процесс удаляет удаляет всю запись об активе или группе активов из внутренней записи MySQL Enterprise Service Manager. Это позволяет вам удалить записи для кластеров, топологии, агентов, хостов и экземпляров, которые были проверены, но больше не используются.

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

Для получения дополнительной информации об инвентаре см. приложение B.

Эта секция описывает следующее:

Получение информации об активе

Утилита curl может использоваться, чтобы запросить информацию непосредственно у инвентаря MySQL Enterprise Service Manager проверенных активов. Чтобы получить информацию о том, может ли определенный актив быть удален, как массив JSON, выполните curl со следующим синтаксисом:

curl -k -v --user username:password \
     "https://servername:port/v4/inventory/AssetType/AssetID/deletable

Здесь:

  • username:password имя пользователя и пароль с доступом администратора к MySQL Enterprise Service Manager.

  • servername:port имя сервера и номер порта для MySQL Enterprise Service Manager.

  • AssetType тип информации об активе, которую вы хотите восстановить. Действительные типы актива следующие:

    • Экземпляры MySQL: com.mysql.etools.inventory.model.mysql.MysqlServer

    • Агенты MySQL Enterprise Monitor: com.mysql.etools.inventory.model.agent.Agent

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

    • Хосты: com.mysql.etools.inventory.model.os.Host

      Невозможно удалить хост из инвентаря, если хост содержит агенты или экземпляры MySQL, которые также не намечены для удаления в той же самой операции.

    • Кластеры NDB: com.mysql.etools.inventory.model.mysql.cluster.NdbCluster

    • Узлы NDB API: com.mysql.etools.inventory.model.mysql.cluster.NdbApiNode

      Удаление узла NDB API также удаляет сервер.

    • Узлы данных NDB: com.mysql.etools.inventory.model.mysql.cluster.NdbDataNode

    • Узлы управления NDB: com.mysql.etools.inventory.model.mysql.cluster.NdbManagementNode

  • AssetID уникальный алфавитно-цифровой идентификатор типа актива.

    Чтобы узнать AssetID, проверьте страницу инвентаря на определенный тип актива. См. приложение B для получения дополнительной информации.

Следующий пример получает информацию для экземпляра MYSQL с уникальным идентификатором c14ee437-a615-11e4-8334-f8b156b72e61:

В следующем примере разрывы строки были добавлены для ясности.

curl -k -v --user admin:mysql \
     "https://localhost:18443/v4/inventory/com.mysql.etools.inventory.model.mysql.MysqlServer/
     c14ee437-a615-11e4-8334-f8b156b72e61/deletable"

Если экземпляр MySQL удаляемый, запрос возвращает следующие данные, подтверждая, что тип актива может быть удален из инвентаря:

"asset" : {"id" : "c14ee437-a615-11e4-8334-f8b156b72e61",
   "assetClass" : "com.mysql.etools.inventory.model.mysql.MysqlServer"
}, "isDeletable" : true, "treeDeletable" : true, "problems" : [ ],
   "token" : "3b66cd39467791a739e5131a8d6a856b"

здесь:

  • asset: перечисляет id и класс активов требуемого актива.

  • isDeletable: True|False. Показывает может ли информация актива быть удалена из инвентаря.

  • treeDeletable: True|False. Показывает могут ли быть удалены связанные активы.

  • problems: перечисляет причины, почему информация актива не может быть удалена из инвентаря. Возможные причины:

    • ACL_FAIL: у пользователя недостаточные привилегии, чтобы выполнить операцию.

      Удаление актива требует права Administer для Server Group и MySQL NDB Cluster. Чтобы удалить актив из инвентаря, пользователь должен принадлежать к роли с этим правом.

      См. раздел 22.3 .

    • IS_LIVE: агент работает. Агент работает и широковещательная информация поступает Service Manager. Невозможно удалить работающий актив из инвентаря. Чтобы удалить актив из инвентаря, необходимо сначала остановить или деинсталлировать его.

    • UNKNOWN_LIVENESS: статус агента не мог быть определен. Эта проблема может быть вызвана сетевыми проблемами или некоторой другой проблемой, такой как прекращение подачи электроэнергии, препятствуя тому, чтобы Service Manager связался с агентом.

    • AGENT_HAS_UNRELATED_SERVER: невозможно удалить сервер и связанный агент, если агент контролирует экземпляр MySQL, не включенный в пределы запроса. Чтобы включать его, необходимо расширить объем связанного запроса путем включения ключевого слова agent.

    • OS_HAS_UNRELATED_AGENT: невозможно удалить хост, который содержит агент, не намеченный для удаления. Хост содержит агент, который не включен в объем запроса. Чтобы включать его, необходимо расширить объем связанного запроса путем включения ключевого слова agent.

    • OS_HAS_UNRELATED_SERVER: невозможно удалить хост, который содержит экземпляр MySQL, не намеченный для удаления. Хост содержит экземпляр MySQL, который не включен в объем запроса. Чтобы включать его, необходимо расширить объем связанного запроса путем включения ключевого слова mysqlserver.

  • token: уникальный алфавитно-цифровой идентификатор для статуса актива. Этот символ может использоваться в запросе DELETE, чтобы подтвердить, что статус актива не изменился между запросами deletable и DELETE.

Запрос также возвращает код статуса, указывающий на успешность или неуспешность запроса. Для получения дополнительной информации посмотрите здесь.

Листинг связанных удаляемых активов

Запрос related позволяет вам возвратить данные по другим активам, которые связаны с основным активом, определенным в области типа. Например, можно запросить удаляемую информацию для экземпляра MySQL и для агента, контролирующего его, хоста, на котором это работает и так далее. related также позволяет вам удалить много активов из инвентаря одним запросом.

related берет список разделенных запятой значений следующих значений:

  • agent: любые агенты, связанные с основным активом.

  • mysqlserver: любые экземпляры MySQL, связанные с основным активом.

  • ndbcluster: любые NDB Cluster, связанные с основным активом.

  • os: любые хосты, связанные с основным активом.

Синтаксис запроса следующий:

curl -k -v --user username:password \
     "https://servername:port/v4/inventory/AssetType/AssetID/deletable?
     related=agent,mysqlserver,ndbcluster,os"

Например, следующее запрашивает удаляемую информацию по серверу MySQL с AssetID c14ee437-a615-11e4-8334-f8b156b72e61 и агенту, контролирующем его:

curl -k -v --user admin:mysql \
     "https://localhost:18443/v4/inventory/com.mysql.etools.inventory.model.mysql.MysqlServer/
     c14ee437-a615-11e4-8334-f8b156b72e61/deletable?related=agent"

Следующее множество JSON возвращено:

"asset" : {
  "id" : "c14ee437-a615-11e4-8334-f8b156b72e61",
  "assetClass" : "com.mysql.etools.inventory.model.mysql.MysqlServer"
},
  "isDeletable" : true,
  "treeDeletable" : false,
  "problems" : [ ],
  "children" : [ {
    "asset" : {
      "id" : "b68947f9-39f2-4003-981f-8c9cc7a7409f",
      "assetClass" : "com.mysql.etools.inventory.model.agent.Agent"
    },
    "isDeletable" : false,
    "treeDeletable" : false,
    "problems" : [ {
      "code" : "IS_LIVE",
      "description" : "IS_LIVE"
    } ]
  } ], "token" : "d0e3607f6029a91a35a9956950908761"

Данные показывают, что, в то время как экземпляр MySQL удаляемый, это не treeDeletable, что означает, что это не может быть удалено в связанном DELETE, потому что контролирующий агент все еще работает.

Удаление активов из инвентаря

Чтобы удалить отдельные активы из инвентаря MySQL Enterprise Service Manager, используйте следующий синтаксис:

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

curl -k -v -X DELETE --header "X-Requested-With:XMLHttpRequest" \
     --header "If-Match:tokenID" --user admin:mysql \
     "https://servername:port/v4/inventory/AssetType/AssetID"

Чтобы удалить связанные активы из инвентаря MySQL Enterprise Service Manager, используйте следующий синтаксис:

curl -k -v -X DELETE --header "X-Requested-With:XMLHttpRequest" \
     --header "If-Match:tokenID" --user admin:mysql \
     "https://servername:port/v4/inventory/AssetType/AssetID?
     related=agent,mysqlserver,ndbcluster,os"

--header "If-Match:tokenID" дополнительный и должен использоваться только, если вы хотите подтвердить, что удаляемая информация все еще точна. Если tokenID включен и соответствует значению, возвращенному удаляемым запросом, операция DELETE выполняется.

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

curl -k -v --user admin:mysql \
     "https://localhost:18443/v4/inventory/com.mysql.etools.inventory.model.agent.Agent/
     d71ff41c-affd-4ebe-966e-395e6f06b5e3/deletable?related=mysqlserver,os,agent"
{
  "asset" : {
    "id" : "d71ff41c-affd-4ebe-966e-395e6f06b5e3",
    "assetClass" : "com.mysql.etools.inventory.model.agent.Agent"
  },
  "isDeletable" : true,
  "treeDeletable" : true,
  "problems" : [ ],
  "children" : [ {
    "asset" : {
      "id" : "sid:{S-1-5-21-700548433-2193620149-503502644}",
      "assetClass" : "com.mysql.etools.inventory.model.os.Host"
    }, "isDeletable" : true, "treeDeletable" : true,
    "problems" : [ ],
    "children" : [ {
      "asset" : {
        "id" : "b68947f9-39f2-4003-981f-8c9cc7a7409f",
        "assetClass" : "com.mysql.etools.inventory.model.agent.Agent"
      },
      "isDeletable" : true,
      "treeDeletable" : true,
      "problems" : [ ],
      "children" : [ {
        "asset" : {
          "id" : "c14ee437-a615-11e4-8334-f8b156b72e61",
          "assetClass" : "com.mysql.etools.inventory.model.mysql.MysqlServer"
        },
        "isDeletable" : true,
        "treeDeletable" : true,
        "problems" : [ ]
      } ]
    } ]
  } ], "token" : "7048b6e53c81f549b55c5f3e861c2eee"

Следующий пример показывает связанный запрос DELETE, удаляя все активы, перечисленные как удаляемые в примере:

curl -k -v -X DELETE --header "X-Requested-With:XMLHttpRequest" \
     --user admin:mysql "https://localhost:18443/v4/inventory/com.mysql.etools.inventory.model.agent.Agent/
     d71ff41c-affd-4ebe-966e-395e6f06b5e3?related=mysqlserver,os,agent"

В настоящее время невозможно удалить всю топологию репликации, в отличие от NDB Cluster, который может быть удален, используя тип актива com.mysql.etools.inventory.model.mysql.cluster.NdbCluster.

Чтобы удалить активы, вовлеченные в топологию репликации, необходимо удалить каждого индивидуально или использовать тип запроса related, если это возможно.

Request Status Codes

Код статуса может быть найден в следующем разделе сообщения после HTTP/1.1:

HTTP/1.1 200
Set-Cookie: JSESSIONID=8C0C2E1AFD45F170E7E41621F934723D; Path=/; Secure; HttpOnly
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Content-Type-Options: nosniff
Content-Type: application/json
Transfer-Encoding: chunked
Date: Tue, 24 Jul 2018 12:31:47 GMT

Следующие коды статусов возвращены для запросов deletable и DELETE:

  • 200: удаляемый запрос был успешен. Содержание возвращено во множестве JSON.

  • 204: запрос DELETE был успешен. Никакое содержание не возвращено.

  • 400: запрос недействителен. Проверьте информацию об активе или синтаксис запроса на ошибки, опечатки и так далее.

  • 403: (только запрос DELETE) заголовок X-Requested-With отсутствует.

  • 404: неправильный AssetID.

  • 409: не было возможно выполнить запрос DELETE. Дополнительная информация предоставляется во множестве JSON.

  • 412: требуемая проверка токена потерпела неудачу.

Поиск

 

Найди своих коллег!

Вы можете направить письмо администратору этой странички, Алексею Паутову. mailto:alexey.v.pautov@mail.ru