Nossa integração F5 BIG-IP coleta e envia inventário e métricas da sua instância F5 BIG-IP para nossa plataforma, onde você pode agregar e visualizar métricas-chave de desempenho. Coletamos dados nos níveis de sistema, aplicativo, pool, membro do pool, servidor virtual e nó.
Continue lendo para instalar a integração e ver quais dados coletamos.
Compatibilidade e requisitos
Nossa integração é compatível com F5 BIG-IP 11.6 ou superior.
Antes de instalar a integração, certifique-se de atender aos seguintes requisitos:
- Instale o agente de infraestrutura.
- Distribuição Linux ou versão Windows compatível com o agente de infraestrutura.
- Conta de usuário F5 BIG-IP com privilégios de usuário de acesso em nível de auditor e permissões de acesso à API REST do iControl.
Instalar e ativar
Para instalar a integração F5 BIG-IP, escolha sua configuração:
Notas Adicionais:
Recomendamos que você instale a integração em um servidor separado e monitor o F5 remotamente.
Advanced:
Também é possível instalar a integração a partir de um arquivo tarball. Isso lhe dá controle total sobre o processo de instalação e configuração.
On-host integrations do not automatically update.
Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.
Habilite sua instância F5
Crie um novo usuário F5 BIG-IP e atribua permissões de usuário:
- Crie uma conta de usuário com, no mínimo, permissões de acesso em nível de auditor. Para obter instruções sobre como fazer isso, consulte a documentação oficial do F5.
- Depois que o usuário for criado, atribua ao usuário permissões de usuário REST do iControl.
Dica
Podem ser necessárias permissões de nível de administrador para coletar algumas métricas de amostra do sistema ou dados de configuração de inventário do sistema . Para mais informações sobre os níveis de permissão do usuário, consulte a documentação oficial da F5 em descrições de acesso ao perfil do usuário.
Este documento ajudou você na instalação?
Configurar a integração
Existem diversas formas de configurar a integração, dependendo de como ela foi instalada:
- Se habilitado via Kubernetes, consulte monitorar serviços em execução no Kubernetes.
- Se habilitado por meio do Amazon ECS, consulte monitorar serviços em execução no ECS.
- Se instalado via on-host, edite a configuração no arquivo de configuração YAML da integração,
f5-config.yml
.
A configuração no formato YAML de uma integração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. As opções que você altera dependem de sua configuração e preferência.
O arquivo de configuração possui configurações comuns aplicáveis a todas as integração, como interval
, timeout
e inventory_source
, entre outras. Para obter mais informações sobre essas configurações comuns, consulte nosso documento de lista de propriedades de configuração .
Se você ainda estiver usando nossos arquivos de configuração/definição legados, consulte integração no host standard configuração format.
Configurações específicas relacionadas a F5 são definidas usando a seção env
do arquivo de configuração. Essas configurações controlam a conexão com sua instância F5, bem como outras configurações de segurança e recurso.
Dica
Após a versão 2.6.0, a integração é construída aproveitando o golang 1.18.0. O cliente HTTP não depende mais do CommonName para validar o certificado.
O comportamento obsoleto e legado de tratar o campo CommonName em certificados X.509 como um nome de host quando nenhum nome alternativo de entidade está presente agora está desabilitado por padrão. Para superar esse problema, o usuário deve atualizar o certificado com base em
Subject Alternative Name
. Enquanto o certificado não for atualizado, a validação do certificado poderá ser desativada configurando--tls_insecure_skip_verify
como verdadeiro.
Configurações da instância F5
A integração F5 coleta informações métricas(M) e de inventário(I). Na tabela, use a coluna Applies To para as configurações disponíveis para cada coleção:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Contexto | Descrição | Padrão | Aplica-se a |
---|---|---|---|
HOSTNAME | Nome do host ou IP onde o F5 está rodando. | host local | MI |
PORT | Porta na qual a API F5 está escutando. | 443 | MI |
USERNAME | Nome de usuário para acessar a API F5. | N/A | MI |
PASSWORD | Senha do usuário fornecido. | N/A | MI |
CA_BUNDLE_FILE | Arquivo de pacote da Autoridade de Certificação Alternativa. | N/A | MI |
CA_BUNDLE_DIR | Diretório de pacote da Autoridade de Certificação Alternativa. | N/A | MI |
TIMEOUT | Tempo limite para solicitações, em segundos. | 30 | MI |
PARTITION_FILTER | Uma matriz JSON de partições BIG-IP para coletar. Veja este exemplo apenas de métrica com filtragem de partição. | ["Common"] | M |
MAX_CONCURRENT_REQUESTS | Número máximo de solicitações em execução simultaneamente. | 10 | M |
TLS_INSECURE_SKIP_VERIFY | Ignore a verificação do certificado enviado pelo host. | false | MI |
METRICS | Defina como | false | |
INVENTORY | Defina como | false |
Você pode definir esses valores de configuração de diferentes maneiras, dependendo da sua preferência e necessidade:
- Adicione o valor diretamente no arquivo de configuração. Esta é a forma mais comum.
- Substitua os valores das variáveis de ambiente usando a notação
{{}}
. Isto requer o agente de infraestrutura v1.14.0 ou superior. Leia mais sobre como usar passthrough ou veja o exemplo de substituição de variáveis de ambiente. - Use o gerenciamento de segredos para proteger informações confidenciais, como senhas, que seriam expostas em texto simples no arquivo de configuração. Para obter mais informações, leia mais sobre como usar o gerenciamento de segredos.
Etiquetas/atributo personalizado
Você também pode decorar sua métrica com etiquetas. Os rótulos permitem adicionar atributo de par de valor principal à sua métrica, que você pode usar para consultar, filtrar ou agrupar sua métrica.
Nosso arquivo de configuração de amostra padrão inclui exemplos de rótulos. Você pode remover, modificar ou adicionar novos de sua escolha.
labels: env: production role: load_balancer
Exemplo de configuração
Encontre e use dados
Para encontrar seus dados de integração, acesse one.newrelic.com > All capabilities > Infrastructure > Third-party services e selecione um dos links de integração F5 BIG-IP.
Os dados F5 BIG-IP são anexados aos seguintes tipos de eventos:
F5BigIpSystemSample
F5BigIpVirtualServerSample
F5BigIpPoolSample
F5BigIpPoolMemberSample
F5BigIpNodeSample
Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.
Dados métricos
A integração F5 BIG-IP recolhe os seguintes dados métricos atributo. Alguns nomes de métricas são prefixados com um indicador de categoria e um ponto, como system.
, virtualserver.
ou pool.
.
Métrica de amostra do sistema
Esses atributos podem ser encontrados consultando os tipos de evento F5BigIpSystemSample
.
Métrica | Descrição |
---|---|
| Quantidade de ticks de CPU que a CPU ficou ociosa por segundo. Requer permissões de usuário em nível de administrador para coletar. |
| Porcentagem média de tempo que a CPU fica ociosa. |
| Porcentagem média de tempo que a CPU está manipulando solicitações de interrupção. |
| Porcentagem média de tempo que a CPU aguarda IO. |
| Porcentagem média de tempo que a CPU está lidando com processos de bom nível. |
| Porcentagem média de tempo que a CPU está manipulando solicitações de interrupção suave. |
| Porcentagem média de tempo que a CPU está manipulando ciclos recuperados pelo hipervisor. |
| Quantidade de ticks de CPU usados pelos processos do kernel por segundo. Requer permissões de usuário em nível de administrador para coletar. |
| Porcentagem média de tempo que a CPU é usada pelo kernel. |
| Quantidade de ticks de CPU usados pelos processos do usuário por segundo. Requer permissões de usuário em nível de administrador para coletar. |
| Porcentagem média de tempo que a CPU é usada pelos processos do usuário. |
| Quantidade total de memória livre, em bytes. |
| Quantidade total de memória, em bytes. Requer permissões de usuário em nível de administrador para coletar. |
| Quantidade total de memória usada, em bytes. Requer permissões de usuário em nível de administrador para coletar. |
| Memória livre reservada para processos do plano de controle, em bytes. |
| Memória total reservada para processos do plano de controle, em bytes. |
| Memória utilizada reservada para processos do plano de controle, em bytes. |
| Espaço de troca livre, em bytes. |
| Total de espaço de troca, em bytes. |
| Espaço de troca usado, em bytes. |
| Memória livre reservada para Traffic Management Microkernel (TMM), em bytes. |
| Total de memória reservada para Traffic Management Microkernel (TMM), em bytes. |
| Memória utilizada reservada para Traffic Management Microkernel (TMM), em bytes. |
Métrica de amostra de servidor virtual
Esses atributos podem ser encontrados consultando o tipo de evento F5BigIpVirtualServerSample
.
Métrica | Descrição |
---|---|
| A disponibilidade definida pelo BIG-IP. Opções:
|
| A taxa de conexões criadas por meio do lado do cliente do objeto por segundo. |
| Indica se o multiprocessamento cluster (CMP) está ativado ou não. |
| Mostra os indicadores do modo Multiprocessamento cluster (CMP). Opções:
|
| O número atual de conexões do BIG-IP. |
| Duração máxima da conexão do lado do cliente do objeto. |
| Duração mínima da conexão do lado do cliente do objeto. |
| O estado habilitado atual. Opções:
|
| Número total de bytes através da porta efêmera por segundo. |
| Número total de bytes enviados pela porta efêmera por segundo. |
| A taxa de criação de conexão por meio da porta temporária por segundo. |
| O número atual de conexões por meio da porta efêmera. |
| O número de conexões removidas por meio da porta temporária por segundo. |
| Número máximo de conexões através da porta efêmera. |
| O número de pacotes que passam pela porta efêmera por segundo. |
| O número de pacotes enviados pela porta efêmera por segundo. |
| O número de conexões lentas eliminadas por meio da porta temporária por segundo. |
| A taxa de conexões removidas por segundo. |
| A quantidade de dados recebidos do servidor virtual BIG-IP, em bytes. |
| A quantidade de dados enviados ao servidor virtual BIG-IP, em bytes. |
| O número de pacotes recebidos do servidor virtual BIG-IP. |
| O número de pacotes enviados ao servidor virtual BIG-IP. |
| O número de solicitações no último intervalo de coleta para BIG-IP. |
| O número de conexões lentas eliminadas no lado do cliente do objeto por segundo. |
| Uma explicação do status atual. |
| A proporção de uso do servidor virtual. |
Métrica de amostra de pool
Esses atributos podem ser encontrados consultando o tipo de evento F5BigIpPoolSample
.
Métrica | Descrição |
---|---|
| O número de membros ativos do pool. |
| O estado de disponibilidade atual. Opções:
|
| O número atual de conexões. |
| A idade da fila com decaimento exponencial máximo. |
| A média móvel exponencial da idade da fila. |
| O cabeçalho de idade da fila atual. |
| A idade máxima da fila em todos os tempos. |
| A soma da idade máxima da fila do membro do pool com decaimento exponencial. |
| A soma da média móvel exponencial da idade da fila do membro do pool. |
| A soma do limite de idade da fila do membro do pool. |
| A soma da idade máxima da fila do membro do pool em todos os tempos. |
| A soma da profundidade do membro do pool. |
| A profundidade da fila. |
| As conexões atuais. |
| O estado atual ativado pode ser definido pelo usuário. Opções:
|
| A quantidade de dados recebidos do pool BIG-IP, em bytes. |
| Pool de membros ativos mínimos. |
| A quantidade de dados enviados ao pool BIG-IP, em bytes. |
| O número de pacotes recebidos do pool BIG-IP. |
| O número de pacotes enviados para o pool BIG-IP. |
| O número total de solicitações para o pool. |
| Propriedade textual explicando o motivo geral de saúde. |
Métrica de amostra de membro do pool
Esses atributos podem ser encontrados consultando o tipo de evento F5BigIpPoolMemberSample
.
Métrica | Descrição |
---|---|
| A disponibilidade atual do sistema BIG-IP. Opções:
|
| As conexões atuais. |
| Estado habilitado do membro do pool em relação ao pool pai. Opções:
|
| A quantidade de dados recebidos do membro do pool BIG-IP, em bytes. |
| O status do monitor. Opções:
|
| A quantidade de dados enviados ao membro do pool BIG-IP, em bytes. |
| O número de pacotes recebidos do membro do pool BIG-IP. |
| O número de pacotes enviados ao membro do pool BIG-IP. |
| O número atual de solicitações durante o último intervalo de coleta. |
| A contagem da sessão atual. |
| O status de saúde da sessão atual. Opções:
|
| O estado atual. Opções:
|
| Explicação do status atual. |
Métrica de amostra de nó
Esses atributos podem ser encontrados consultando o tipo de evento F5BigIpNodeSample
.
Métrica | Descrição |
---|---|
| O estado atual de disponibilidade do BIG-IP para o nó. Opções:
|
| O número atual de conexões de rede do BIG-IP. |
| O número de conexões feitas por segundo. |
| O estado atual habilitado para BIG-IP. Opções:
|
| A quantidade de dados recebidos do nó BIG-IP, em bytes. |
| O status atual da regra do monitor de integridade. Opções:
|
| A quantidade de dados enviados ao nó BIG-IP, em bytes. |
| O número de pacotes recebidos do nó BIG-IP. |
| O número de pacotes enviados para o nó BIG-IP. |
| O número atual de solicitações na última coleta do BIG-IP. |
| O número atual de sessões. |
| O status atual da sessão. Opções:
|
| Razão BIG-IP para o status atual. |
Dados de inventário
A integração F5 BIG-IP também coleta dados de configuração nos níveis de sistema, aplicativo, pool, membro do pool, servidor virtual e nó.
Os dados estão disponíveis na página Inventário na interface da infraestrutura, na fonte config/f5 . Para obter mais informações sobre dados de inventário, consulte Compreender os dados de integração.
A integração captura dados para o seguinte parâmetro de configuração F5 BIG-IP:
Verifique o código-fonte
Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.