> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Minutely probes

Minutely probes são um mecanismo para enviar periodicamente métricas customizadas ao AppSignal. Em intervalos de um minuto, a partir de quando o probe foi criado pela primeira vez, uma função definida pelo usuário pode ser chamada na qual você pode capturar métricas para enviá-las ao AppSignal. As funções de minutely probe são executadas de forma assíncrona.

A partir da versão `2.3.0`, você pode habilitar ou desabilitar os minutely probes completamente com a opção de configuração [`enableMinutelyProbes`](/nodejs/3.x/configuration/options#option-enableminutelyprobes).

## Criando probes

Se você precisa rastrear métricas customizadas no seu app, pode adicionar seus próprios probes. Para registrar um probe, é preciso chamar o método `probes.register()` com dois argumentos: um nome de probe e uma função anônima a ser chamada uma vez por minuto.

<CodeGroup>
  ```javascript Node.js theme={null}
  const meter = appsignal.metrics();
  const probes = meter.probes();

  // the callback is fired once every minute from when
  // `register` is called
  probes.register("database", () => {
    meter.setGauge("database_size", 10);
  });
  ```
</CodeGroup>

Para garantir que todos os minutely probes sejam executados em tempo hábil, é importante evitar bloquear o event loop por longos períodos dentro de um callback de minutely probe.

## Sobrescrevendo os probes padrão

Por padrão, `@appsignal/nodejs` configura um minutely probe que mantém registro das estatísticas de heap do V8 do Node.js. Para desabilitar esse probe, use `probes.unregister()`:

<CodeGroup>
  ```javascript Node.js theme={null}
  const probes = appsignal.metrics().probes();

  probes.unregister("v8_stats");
  ```
</CodeGroup>

Antes da versão `2.3.0`, `probes.unregister()` não está disponível. Em versões anteriores à `2.3.0`, você pode usar a opção de configuração [`enableMinutelyProbes`](/nodejs/3.x/configuration/options#option-enableminutelyprobes) para desabilitar o probe padrão.