Página inicial do Docs → MongoDB Ops Manager

Obter medições de partição de disco

Nesta página

Recurso

Parâmetros do caminho da solicitação
Solicitar parâmetros de query
Parâmetros do corpo da solicitação
Resposta
Exemplo de solicitação
Exemplo de resposta
Cabeçalho de resposta
Corpo de resposta

Gerente de Operações v6.0 fará EOL em janeiro 2025. Atualize para uma versão superior do Ops Manager o mais rápido possível.

As medições de disco fornecem dados sobre IOPS, uso de disco e latência de disco nas partições de disco para hosts que executam o MongoDB que as automações coletam. Você deve executar a automação do Ops Manager para recuperar as medições do disco.

Observação

Para calcular algumas séries de métricas, o Ops Manager obtém a taxa entre cada dois pontos adjacentes. For these metric series, the first data point has a null value because Ops Manager can't calculate a rate for the first data point given the query time range.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Recurso

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/disks/{PARTITION-NAME}/measurements

Parâmetros do caminho da solicitação

Nome	Tipo	Descrição
ID do projeto	string	Identificador exclusivo doprojeto que possui o host.
ID DE HOST	string	Identificador único do host que atende ao processo do MongoDB.
NAVIO-PARTITION	string	Nome da partição do disco na qual o processo do MongoDB está armazenado.

Solicitar parâmetros de query

Parâmetros de query únicos

Esse endpoint aceita os seguintes parâmetros de query para filtrar as medições retornadas:

Nome

Tipo

Descrição

granularidade

Obrigatório

string

Duração em ISO 8601 notação que especifica o intervalo entre pontos de dados de medição.

A granularidade de medição pode ser expressa como dias, horas, minutos, segundos e milissegundos usando a seguinte notação:

P (para o período) seguido por:

D por dias (se desejado)
T por tempo (após dias)
H por horas
M por minutos
S por segundos

Exemplo

Notação	duração
`PT30S`	30 segundos
`P1T12H`	1 dia, 12 horas
`PT0.5S`	500 milissegundos

período

string

Duração na ISO 8601 notação que especifica até que ponto no passado para recuperar as medições.

Exemplo

Para solicitar as últimas 36 horas, inclua este parâmetro de query: period=P1DT12H.

iniciar

string

Carimbo de data/hora na ISO 8601 formato de data e hora em UTC para o início do período para o qual recuperar as medições. Se você especificar ,start também deverá especificar end.

fim

string

Carimbo de data/hora na ISO 8601 formato de data e hora em UTC para o final do período para o qual recuperar as medições. Se você especificar ,end também deverá especificar start.

string

Medições a serem retornadas. Se m não for especificado, todas as medições serão retornadas.

Para especificar valores múltiplos para m, você deve repetir o parâmetro m .

Exemplo

../measurements?m=CONNECTIONS&m=OPCOUNTER_CMD&m=OPCOUNTER_QUERY

Você deve especificar medições que são válidas para o host. O Ops Manager retornará um erro se alguma medição especificada for inválida. Para obter as medições disponíveis, consulte Tipos de medição.

Observação

Cada solicitação de medição deve incluir o parâmetro de query period ou os parâmetros de query start e end .

Parâmetros de query comuns

Esse endpoint também aceita os parâmetros de query comuns a todos os endpoints que retornam uma única resposta:

Nome

Tipo

Descrição

default

pageNum

inteiro

Número da página (com base em índice 1).

1

itemsPerPage

inteiro

Número de itens a serem devolvidos por página, até um máximo de 500.

100

pretty

boleano

Indica se o corpo da resposta deve estar em um prettyprint formato.

false

envelope

boleano

Indica se deseja ou não envolver a resposta em um envelope.

Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, configure "envelope" : true na query.

Para endpoints que retornam um resultado, o corpo da resposta inclui:

Status	Código de resposta HTTP
envelope	Corpo de resposta esperado

Para endpoints que retornam uma lista de resultados, o objeto results é um envelope. O Ops Manager adiciona o campo status ao corpo da resposta.

none

Parâmetros do corpo da solicitação

Este endpoint não usa parâmetros do corpo da solicitação HTTP.

Resposta

Nome	Tipo	Descrição
Nome do Banco de Dados	string	Banco de dados ao qual a medição se aplica. Preenchido apenas para Obter medições de reconhecimento de data center .
fim	string	Carimbo de data/hora na ISO 8601 formato de data e hora em UTC para o final do período coberto pelas medições retornadas.
granularidade	string	Duração na ISO 8601 notação que especifica o tamanho do intervalo que cada ponto de dados cobre. Exemplo `PT5M` especifica uma granularidade de 5 minutos.
groupId	string	Identificador único do projeto que possui o host.
hostId	string	Identificador único do host ao qual as medições pertencem.
medições	array de objetos	Cada objeto nesta array representa uma medição e os pontos de dados para esta medição.
metrics.dataPoints	array de objetos	Cada objeto representa um único ponto de dados. Se não houver nenhum ponto de dados disponível para um determinado momento no tempo, esse `value` será definido como `null`.
metrics.dataPoints.timestamp	string	Carimbo de data/hora na ISO 8601 formato de data e hora em UTC para o início do intervalo de tempo que esse ponto de dados representa.
metrics.dataPoints.value	flutuar	Valor deste ponto de dados.
metrics.name	string	Nome da medição. Os valores aceitos são fornecidos na página Tipos de Medição .
metrics.units	string	Como essa medição é contabilizada. As unidades aceitas são: `PERCENT` `MILLISECONDS` `BYTES` `GIGABYTES` `BYTES_PER_SECOND` `MEGABYTES_PER_SECOND` `GIGABYTES_PER_HOUR` `SCALAR_PER_SECOND` `SCALAR`
partitionName	string	Nome da partição de disco que armazena o reconhecimento de data center de processos MongoDB. Preenchido apenas para obter medições de partição de disco .
processId	string	FQDN e porta do processo MongoDB.
iniciar	string	Carimbo de data/hora na ISO 8601 formato de data e hora em UTC para o início do período coberto pelas medições retornadas.

Exemplo de solicitação

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/disks/{PARTITION-NAME}/measurements?granularity={TIME-INCREMENT}&period={PERIOD}"

Exemplo de resposta

Cabeçalho de resposta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Corpo de resposta

{
  "granularity": "{TIME-INCREMENT}",
  "groupId": "{PROJECT-ID}",
  "hostId": "{HOST-ID}",
  "links": [
  ],
  "measurements": [
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_READ",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_WRITE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_TOTAL",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_LATENCY_READ",
      "units": "MILLISECONDS"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_LATENCY_WRITE",
      "units": "MILLISECONDS"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_FREE",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_USED",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_PERCENT_FREE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_PERCENT_USED",
      "units": "PERCENT"
    }
  ],
  "partitionName": "{PARTITION-NAME}",
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}"
}

← Obtenha medições de host, processo e sistema

Obter medições do reconhecimento de data center →