Глава 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.

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

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 содержит следующие вкладки:

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.

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

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

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

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

  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

Здесь:

Следующий пример получает информацию для экземпляра 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"

здесь:

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

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

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

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

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

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: