Este documento contém requisitos e regras gerais para inserção e utilização de eventos personalizados e seus atributos associados. Requisitos adicionais podem ser aplicados com base no método usado.
Você pode relatar eventos personalizados para o New Relic de diversas maneiras, incluindo:
- API do agente
- API de evento (existem requisitos adicionais ao usar a API de evento.)
- API do agente e (existem requisitos adicionais com o evento
PageAction
personalizado.) - Monitoramento de Mobile SDK
Requerimentos gerais
Ao relatar eventos personalizados e atributo, siga estes requisitos gerais para tipos de dados suportados, sintaxe de nomenclatura e tamanho:
Requerimento | Descrição |
---|---|
carga | Tamanho ou comprimento máximo total: 1MB (10^6 bytes) maximum per POST. É altamente recomendável usar compactação. A carga deve ser codificada como UTF-8. A API de eventos possui limites adicionais de taxa HTTP. |
Tipos de dados de atributo | Os valores de atributo podem ser uma string ou um número inteiro ou float. Para obter informações sobre a formatação de dados de data e hora, consulte Data/hora personalizada. |
Limites de atributo | Comprimento máximo do nome do atributo: 255 caracteres. Comprimento máximo dos valores do atributo personalizado:
|
Sintaxe de nomenclatura para evento e atributo | os nomes dos eventos podem ser uma combinação de caracteres alfanuméricos, dois pontos ( Recomendamos começar os nomes com uma letra: se começar com outra coisa, você precisará colocar crases ao redor do nome durante a consulta. Para obter mais informações sobre quando os crases são necessários em uma consulta, consulte Referência NRQL. Não use palavras reservadas para uso do NRQL. Comprimento máximo do nome do evento: 255 caracteres. |
Valores nulos | O banco de dados não armazena dados com valor nulo. |
Palavras reservadas
Evite usar as seguintes palavras reservadas como nomes para evento e atributo. Caso contrário, poderão ocorrer resultados inesperados.
Importante
Essa não é uma lista completa. Em geral, evite usar palavras reservadas ao MySQL para evitar colisão com funcionalidades futuras do New Relic.
Keyword | Description |
---|---|
| Este é um nome de atributo reservado. Se estiver incluído, será descartado durante a ingestão. |
| O valor deve ser um número inteiro. Se não for um número inteiro, o nome e o valor do atributo serão eliminados durante a ingestão. |
| O tipo de evento armazenado no New Relic. O agente e o script New Relic normalmente relatam isso como |
Valores | Para seu valor
|
| Deve ser um timestamp da Unix epoch. Você pode definir o carimbo de data/hora em segundos ou milissegundos. Deve ser +/-1 dia (24 horas) da hora atual no servidor. |
Termos de encaminhamento de logs | As seguintes chaves são reservadas pelo recurso de encaminhamento de logs do agente de infraestrutura: |
Termos de sintaxe NRQL | Se você precisar usar termos de sintaxe NRQL como nomes de atributo, incluindo atributo pontilhado, eles deverão ser colocados entre crases; por exemplo,
|
Limites de tipo de evento
O limite atual para o número total de valores eventType
é 250 por conta (não por organização) em um determinado período de 24 horas. Se uma conta exceder esse limite, a New Relic poderá filtrar ou descartar dados. os tipos de eventos incluem:
- Evento padrão do agente e integração New Relic
- Evento personalizado de agente ou
- Evento personalizado da API de evento