Configurar a coleta e a publicação de métricas no VMware Cloud Director

Você pode usar o comando configure-metrics da ferramenta de gerenciamento de células do VMware Cloud Director para configurar o conjunto de métricas a serem coletadas.

O VMware Cloud Director pode coletar métricas que fornecem informações atuais e históricas sobre o consumo de recursos e o desempenho da máquina virtual. Use esse subcomando para configurar as métricas que o VMware Cloud Director coleta. Use o subcomando cell-management-toolcassandra para configurar um banco de dados Cassandra Apache para uso como um repositório de métricas do VMware Cloud Director. Consulte Configurando um banco de dados de métricas do Cassandra no VMware Cloud Director.

Procedimento

Faça login diretamente ou usando um cliente SSH no sistema operacional da célula do VMware Cloud Director como root.

Configure as métricas coletadas pelo VMware Cloud Director.

/opt/vmware/vcloud-director/bin/cell-management-tool configure-metrics --metrics-config pathname

Tabela 1. Argumentos e opções da Ferramenta de gerenciamento de células, subcomando configure-metrics
Comando	Argumento	Descrição
--help`(-h)`	Nenhum	Fornece um resumo dos comandos disponíveis nessa categoria.
--repository-host (obsoleto)	Nome do host ou endereço IP do host do KairosDB	Obsoleto. Use a opção --cluster-nodes do subcomando cell-management-toolcassandra para configurar um banco de dados Cassandra Apache para uso como um repositório de métricas do VMware Cloud Director.
--repository-port (obsoleto)	A porta KairosDB a ser usada.	Obsoleto. Use a opção --port do subcomando cell-management-toolcassandra para configurar um banco de dados Cassandra Apache para uso como um repositório de métricas do VMware Cloud Director.
--metrics-confg	nome do caminho	Caminho para o arquivo de configuração de métricas

(Opcional) Ative a publicação de métricas executando o seguinte comando.
```
/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n statsFeeder.metrics.publishing.enabled -v true
```
No VMware Cloud Director 10.2.2, a publicação de métricas está desativada por padrão.

Exemplo: Como configurar uma conexão do banco de dados de métricas

Este exemplo configura a coleção de métricas conforme especificado no arquivo /tmp/metrics.groovy.

[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool configure-metrics --metrics-config /tmp/metrics.groovy

O serviço de coleta de métricas do VMware Cloud Director implementa um subconjunto das métricas coletadas pelo vSphere Performance Manager. Consulte a documentação do vSphere Performance Manager para obter mais informações sobre os nomes de métricas e os parâmetros de coleta. O arquivo metrics-config cita um ou mais nomes de métrica e fornece os parâmetros de coleta de cada métrica citada. Por exemplo:

configuration {
    metric("cpu.usage.average")
    metric("cpu.usagemhz.average")
    metric("cpu.usage.maximum")
    metric("disk.used.latest") {
        currentInterval=300
        historicInterval=300
        entity="VM"
        instance=""
        minReportingInterval=1800
        aggregator="AVERAGE"
    }
}

Há suporte para os seguintes nomes de métrica.

Tabela 2. Nomes de métrica
Nome de métrica	Descrição
`cpu.usage.average`	Modo de host da CPU média usada ativamente desta máquina virtual como uma porcentagem do total disponível. Inclui todos os núcleos em todos os soquetes.
`cpu.usagemhz.average`	Modo de host da CPU média usada ativamente desta máquina virtual como uma medição bruta. Inclui todos os núcleos em todos os soquetes.
`cpu.usage.maximum`	Modo de host da CPU máxima usada ativamente desta máquina virtual como uma porcentagem do total disponível. Inclui todos os núcleos em todos os soquetes.
`mem.usage.average`	Memória usada por esta máquina virtual como uma porcentagem do total de memória configurada.
`disk.provisioned.latest`	Espaço de armazenamento alocado a este disco rígido virtual no centro de dados virtual da organização contentora.
`disk.used.latest`	Armazenamento usado por todos os discos rígidos virtuais.
`disk.read.average`	Taxa de leitura média de todos os discos rígidos virtuais.
`disk.write.average`	Taxa de gravação média de todos os discos rígidos virtuais.

Observação:

Quando uma máquina virtual tem vários discos, o VMware Cloud Director relata métricas de forma agregada para todos os discos. As métricas de CPU são uma agregação de todos os soquetes e núcleos.

Para cada métrica nomeada, você pode especificar os seguintes parâmetros de coleta.

Tabela 3. Parâmetros de coleta de métricas
Nome do parâmetro	Valor	Descrição
`currentInterval`	Quantidade de segundos em número inteiro	O intervalo em segundos a ser usado ao consultar os valores de métrica disponíveis mais recentes para consultas de métricas atuais. O valor padrão é `20`. O VMware Cloud Director oferece suporte a valores maiores que 20 apenas para métricas de Nível 1, conforme definido pelo vSphere Performance Manager.
`historicInterval`	Quantidade de segundos em número inteiro	O intervalo em segundos a ser usado ao consultar os valores de métricas históricas. O valor padrão é `20`. O VMware Cloud Director oferece suporte a valores maiores que 20 apenas para métricas de Nível 1, conforme definido pelo vSphere Performance Manager.
`entity`	Um destes: `HOST`, `VM`	O tipo de objeto VC para o qual a métrica está disponível. O padrão é `VM`. Nem todas as métricas estão disponíveis para todas as entidades.
`instance`	Um identificador de instância `PerfMetricId` do vSphere Performance Manager	Indica se deve ser realizada a recuperação de dados para instâncias individuais de uma métrica, por exemplo, núcleos de CPU individuais, um agregado de todas as instâncias ou ambos. Um valor de `""` coleta todas as métricas, instâncias e agregados. Uma cadeia de caracteres vazia, `""`, coleta apenas os dados agregados. Uma cadeia de caracteres específica como `"DISKFILE"` coleta dados apenas para essa instância. O padrão é `""`.
`minReportingInterval`	Quantidade de segundos em número inteiro	Especifica um intervalo de agregação padrão em questão de segundos para uso ao relatar dados de séries de tempo. Fornece maior controle sobre a granularidade dos relatórios quando a granularidade do intervalo de coleta não é suficiente. O padrão é `0`, ou seja, nenhum intervalo de relatório dedicado.
`aggregator`	Um destes: `AVERAGE`, `MINIMUM`, `MAXIMUM` e `SUMMATION`	O tipo de agregação a ser executado durante o `minReportingInterval`. O padrão é `AVERAGE`.