---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de Métricas de Push

# API de Métricas de Push {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API de métricas de envio fornece endpoints que permitem enviar dados brutos Inteligência operacional de uma fonte externa para o MID Server.

Esta API é baseada em ferramentas do lado do cliente que enviam por push os dados brutos da fonte externa para o MID Server. A extensão Métricas operacionais deve ser configurada com a opção Habilitar ouvinte REST habilitada. Para obter mais informações sobre como configurar o MID Server, consulte [Introdução à Inteligência operacional](https://www.servicenow.com/docs/access?context=get-started-metrics&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US).

Para obter informações sobre requisitos de autenticação, consulte [Configuração da extensão do MID Web Server](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US).

## Métricas de push - POST /mid/sa/metrics {#ariaid-title2}

Envia dados brutos Inteligência operacional de uma fonte externa para o MID Server.

### Formato da URL {#sa-POST-metrics__section_nbn_xsv_3mb}

URL padrão: /api/mid/sa/metrics

### Parâmetros de solicitação compatíveis

{#sa-POST-metrics__entry__2}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 1. Parâmetros de caminho]

{#sa-POST-metrics__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Parâmetros de consulta]

{#sa-POST-metrics__entry__10}

| Nome | Descrição |
|-|-|
| ci2metric_id | Lista de pares de chave-valor a serem usados para identificar o item de configuração (IC). Anteriormente, era conhecido como ci_identifier. O script continua a aceitar ci_identifier. Tipo de dados: objeto |
| metric_type | Nome da métrica. Tipo de dados: cadeia de caracteres |
| node | Endereço IP, FQDN, nome do IC ou host. No exemplo abaixo, o nome do servidor Linux em que os discos estão instalados. Tipo de dados: cadeia de caracteres |
| resource_path | O caminho do recurso para o qual os dados de métrica estão sendo coletados. No exemplo abaixo, `C:\` é o recurso para o qual os dados de métrica são coletados. Tipo de dados: cadeia de caracteres |
| origem | A fonte de dados que monitora o tipo de métrica. Tipo de dados: cadeia de caracteres |
| timestamp | Carimbo de data/hora do período da métrica. Tipo de dados: número Unidade: Milissegundos |
| valor | Valor da métrica. Tipo de dados: número |
[Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#sa-POST-metrics__entry__26}{#sa-POST-metrics__content_type-RESTAPI}

| Cabeçalho | Descrição |
|-|-|
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
[Tabela 4. Cabeçalhos da solicitação]

{#sa-POST-metrics__entry__30}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#sa-POST-metrics__entry__34}{#sa-POST-metrics__entry-200-status-code}{#sa-POST-metrics__entry-401-status-code}{#sa-POST-metrics__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 6. Códigos de status]

### Parâmetros do corpo da resposta (JSON ou XML)

{#sa-POST-metrics__entry__42}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[ ]

### Solicitação de cURL

O corpo da solicitação deve estar entre colchetes, conforme mostrado neste exemplo.

    curl -X POST "https://servicenow-instance/api/mid/sa/metrics"
    -H "Content-Type: application/json"
    -U "username":"password"
    -d "[{
        "metric_type": "Disk C: % Free Space",
        "resource_path": "C:\\",
        "node": "lnux100",
        "value": 50,
        "timestamp": 1473183012000,
        "ci2metric_id": {
            "node": "lnux100"
        },
        "source": "Splunk"
    }]"