A observabilidade do New Relic é construída em torno do conceito de entities. Este documento explica como definimos entidade, o que você pode fazer com elas e como você pode criar sua própria entidade ou agrupamentos de entidade.
Dica
Quer um tour introdutório à plataforma New Relic? Consulte Conheça a plataforma.
O que é uma entidade?
Do ponto de vista da New Relic, entity é propositalmente um conceito amplo. Uma entidade é qualquer coisa que a) reporte dados à New Relic ou que contenha dados aos quais temos acesso eb) seja algo que identificamos com um ID de entidade exclusivo. Para a maioria das entidades, o ID é indicado pelo atributo entityGuid.
Uma entidade pode ser qualquer componente fundamental de relatório de dados, como um aplicativo, um host ou um serviço de banco de dados, mas também pode referir-se a agrupamentos maiores desses componentes. Por exemplo, para monitor um data center, você pode agregar esses hosts no New Relic para formar uma workload (um agrupamento personalizado de entidade). Essa workload é, em si, também uma entidade. Damos-lhe a possibilidade de criar a sua própria entidade.
Também muito importante são as relações entre entidades. Nosso mapeamento de relacionamentos nos bastidores nos ajuda a entender como as entidades estão conectadas e como elas afetam umas às outras. E isso nos permite dar a você o poder de configurar como os dados que você traz estão relacionados à entidade existente ou como estão relacionados a outra entidade.
Nosso foco na entidade e em seus relacionamentos é importante porque nosso objetivo é fornecer practical information about your business-important entities a você, em vez de fornecer um fluxo enorme e inútil de dados de uma lista enorme de serviços e sistemas de monitoramento. Com mais insights no nível da entidade, você pode monitor e solucionar melhor problemas de sistemas modernos e complexos.
one.newrelic.com: ao abrir o New Relic, você acessa a página All entities , que oferece uma visão geral da entidade do seu monitor. Nessa página, você pode visualizar metadados de uma entidade ou clicar em uma entidade para ver detalhes de desempenho.
Filtre e explore sua entidade
A barra de filtro de entidade está disponível em muitas páginas da interface do New Relic, incluindo a visualização de lista de entidade principal, APM, a interface , a interface de infraestrutura e muito mais. Para saber como usar a barra de filtros para explorar a entidade e salvar filtros úteis, consulte filtro de entidade.
Saiba mais sobre entidade
Para encontrar o GUID de uma entidade e outros metadados na interface: em qualquer lista de entidade, clique no nome de uma entidade ícone e clique em See metadata & tags.
Cada entidade possui um número de ID específico da New Relic, que é relatado como o atributo entityGuid. Você pode executar a consulta NRQL da entidade usando seu GUID.
Saiba mais sobre as relações entre entidades
Aqui estão algumas opções para entender as relações entre a entidade monitora:
- Ao visualizar uma entidade na interface, use a interfaceRelated entities .
- Use mapas de serviço para ver uma representação visual das conexões.
- Use distributed tracing para ver como as entidades se comunicam na transação.
- Use nossa API NerdGraph para visualizar informações de relacionamento.
Conheça detalhes técnicos sobre entidade
Para saber detalhes técnicos sobre tipos de entidade, consulte nosso repositório GitHub para nossos tipos de entidade. Por exemplo, para obter detalhes sobre a entidade APM-monitor, consulte Aplicativo APM.
Cada entidade contém vários arquivos que controlam a forma como ela relata os dados. Por exemplo, o arquivo golden_metrics contém informações sobre suas métricas mais importantes, que geralmente são destacadas em nossas experiências de interface. Aqui está o arquivo golden_metrics.yml para APM-monitor entidade.
O arquivo definition de uma entidade contém informações como:
- O
domain: por exemplo,APMouInfra. - É
type: por exemplo,ApplicationouAWSECSCONTAINERINSTANCE. - Etiqueta padrão.
- O
entityExpirationTime: para saber mais sobre isso, consulte Expiração da entidade.
Expiração da entidade
Diferentes tipos de entidade têm períodos de vida diferentes, determinados pelo entityExpirationTime definido no arquivo definition para cada tipo de entidade. Esse prazo de expiração determina por quanto tempo o registro dessa entidade existe no New Relic depois que a entidade para de relatar dados.
A New Relic monitora um grande número de entidades, e muitas dessas entidades têm vida curta (por exemplo, contêiner Kubernetes). Por estes motivos é necessário eliminar regularmente os registos das entidades que deixaram de reportar dados.
Este prazo de expiração refere-se ao registo da própria entidade e não está relacionado com dados de telemetria. Dito de outra forma: os dados de telemetria relatados pela sua entidade monitor podem ser encontrados no NRDB e disponíveis via NRQL, dependendo de suas configurações de retenção de dados. Mas o registro da própria entidade, uma vez expirado, não existirá mais na New Relic.
As opções para o tempo de expiração da entidade são estas:
FOUR_HOURSDAILY(24 horas)EIGHT_DAYS: Valor padrão aplicado se nenhum prazo for definido no arquivodefinition.QUARTERLY(3 meses)MANUAL: Esta configuração se aplica apenas à entidade cuja criação e exclusão são controladas manualmente (por exemplo, carga de trabalho e painel).
Agrupar e organizar entidade
Você pode colocar entidade em grupos que reflitam relacionamentos importantes para os negócios em sua organização. Por exemplo, você pode agrupar todas as entidades relacionadas a uma equipe ou departamento específico, ou relacionadas a um serviço específico. Ou você pode agrupar vários hosts para refletir seu agrupamento em um data center.
Para agrupar sua entidade, consulte:
- tag entidade.
- Crie carga de trabalho, que permite agrupar conjuntos de entidades importantes para o negócio.
- Criar entidade e personalizar dados da entidade
Crie e gerencie suas próprias entidades com síntese de entidades
Se você tiver telemetria de qualquer fonte que não seja compatível com o New Relic imediatamente, poderá propor um mapeamento para ela. Depois de aprovada, qualquer telemetria recebida pela New Relic que corresponda ao seu arquivo de definição será sintetizada em uma entidade.
Aprender mais:
- Para saber o atributo reservado e como são definidas as relações entre entidades, continue lendo este documento.
- Para saber como fazer o trabalho de modificação de tipos de entidade existentes ou de criação de novos, consulte nosso repositório GitHub sobre síntese de entidade.
Atributo reservado para entidade sintetizada
Esses atributos devem ser sintetizados a partir da telemetria que recebemos. Não os defina a menos que esteja ciente das implicações e consequências.
Atributo | Descrição |
|---|---|
| Geralmente, você não deve definir esse campo de atributo nos dados de telemetria. A New Relic pode adicionar este campo aos dados ingeridos para armazenar um identificador exclusivo para a entidade associada ao ponto de dados. Se a telemetria chegar com o atributo Um caso de uso para passar esse atributo é associar a telemetria ingerida a uma entidade que já monitor. Quando o atributo |
| Este atributo não deve ser colocado em dados de telemetria ingeridos, a menos que você esteja tentando substituir o nome da entidade que teria sido selecionado pelo nosso sistema de identificação de entidade. Embora não alteremos o valor se ele já estiver presente nos dados, poderemos adicionar o atributo aos seus dados. Portanto, valores inválidos ou inesperados podem causar comportamento indefinido, como entidade ausente na interface do usuário ou telemetria não associada à entidade esperada. Se este campo estiver presente na telemetria ingerida, o seu valor será utilizado para nomear a entidade associada ao ponto de dados. Este nome será usado em vez do nome selecionado pelo nosso sistema de identificação de entidade (por exemplo, definições de síntese de entidade). Note-se que muitas entidades utilizam o nome como parte da sua identificação, pelo que a alteração deste campo poderá resultar na geração de uma nova entidade. |
| Este atributo não deve ser colocado em dados de telemetria ingeridos, exceto em certos casos legados em que é necessário distinguir tipos de entidade. Passar este campo pode interferir na detecção da entidade, principalmente se valores não reconhecidos forem enviados neste campo. Embora o New Relic não altere o valor se já estiver presente nos dados, não há garantia de que o campo forneça filtragem inequívoca de telemetria no momento da consulta. As definições de entidade existentes já possuem valores sobrepostos e recomendamos evitar Este campo é usado pelo New Relic, o que significa que valores inválidos ou inesperados podem causar comportamento indefinido, como entidade ausente na UI ou telemetria não associada à entidade esperada. |
Para saber como fazer o trabalho de modificar tipos de entidades existentes ou criar novos, consulte nosso repositório GitHub sobre síntese de entidades.
Entidade não instrumentada
Usando sua telemetria, podemos detectar entidades que não estão sendo instrumento no momento, mas são utilizadas pelo seu aplicativo. Por exemplo, um de seus instrumentos pode estar ligando para um banco de dados Amazon RDS que atualmente não é um instrumento da New Relic, portanto, não podemos fornecer nenhuma ferramenta como monitoramento ou alerta para isso.
Nesse caso, criamos uma chamada “entidade não instrumentada” juntamente com o relacionamento com o instrumento. É apresentado no mapa de atendimento da entidade instrumento. Fornecemos instruções claras para instrumentá-lo, exibidas com apenas um clique sobre a entidade.
Relacionamentos de entidade
As conexões entre entidades são criadas automaticamente pela New Relic com base no que podemos inferir da sua telemetria. Por exemplo, quando dois serviços que se comunicam via HTTP são instrumentos com New Relic, inferimos uma relação de “chamadas/chamadas por” entre eles.
Ao visualizar uma entidade nas visualizações entidade explorer, Navigator e Lookout, você pode ver seu Related entities no painel direito. Isto dá uma visualização das diversas entidades ligadas diretamente à entidade atual. Você pode visualizar rapidamente métricas importantes para essas entidades relacionadas e navegar de uma entidade para outra, por todas as partes conectadas da sua stack.
Dica
Aprenda como se aprofundar nos relacionamentos entre entidades com nossa API NerdGraph.
Tipos de relacionamentos de entidade
Entidade podem estar relacionadas entre si de várias maneiras. O recolhido abaixo lista os relacionamentos de entidade suportados. Depois de entender os relacionamentos possíveis, dê uma olhada na lista de relacionamentos criados automaticamente ou considere se deseja criar relacionamentos de entidade personalizados.
Quais relacionamentos são criados automaticamente?
Os relacionamentos automáticos são criados com base na telemetria que está sendo reportada pela entidade. Esses relacionamentos têm um Time To Live (TTL). Isso significa que serão excluídos automaticamente caso as métricas utilizadas para criar o relacionamento não sejam reportadas em um determinado período de tempo. O TTL padrão para um relacionamento é 75 minutos. O TTL pode variar de 10 minutos a 3 dias dependendo do tipo de relacionamento.
Estas são as relações entre entidades que criamos automaticamente:
Crie relacionamentos de entidade personalizados
Quando os relacionamentos não são detectados automaticamente, você pode criá-los manualmente usando nossa API NerdGraph ou pode fazer isso na interface do New Relic com o link Add/edit related entities em Related entities. Atualmente, você só pode criar manualmente relacionamentos de chamadas/chamados por entre entidades de serviço.
Dica
Para gerenciar relacionamentos manuais, você precisa ter recursos de modificação e exclusão em relacionamentos de entidade. Se você não vir o botão editar relacionamentos, entre em contato com o administrador da sua conta.