Antes de enviar eventos de monitor de processo para o AppSignal, você precisa primeiro criar um monitor de processo no AppSignal.
Você pode enviar eventos de monitor de processo para o AppSignal realizando requisições HTTP POST para a API do AppSignal, usando qualquer cliente HTTP. Os exemplos nesta página fornecem um comando cURL de exemplo, bem como o método HTTP bruto e a URL para usar com qualquer cliente HTTP de sua escolha.
Nos exemplos abaixo, substitua YOUR-APP-LEVEL-API-KEY pela push API key no nível do app do AppSignal para seu app, que pode ser encontrada nas configurações “Push & Deploy” da sua aplicação, e YOUR-PROCESS-MONITOR-IDENTIFIER pelo identificador do monitor de processo para o qual você deseja enviar eventos.
A API de Process Monitoring ainda usa check_ins nas URLs de endpoint para
compatibilidade com integrações existentes.
Enviando eventos de monitor de processo cron
Monitores de processo cron são usados para monitorar a execução de jobs agendados, como cron jobs. O AppSignal esperará receber um evento de finalização do monitor de processo cron de acordo com seu agendamento configurado, e notificará você se nenhum evento de finalização do monitor de processo cron for recebido dentro de sua duração máxima configurada.
Adicionalmente, você pode enviar eventos de início de monitor de processo cron ao AppSignal para notificar que um evento de monitor de processo cron começou, permitindo medir a duração dos seus cron jobs.
Finalizar monitor de processo cron
Para notificar o AppSignal que um cron job terminou com sucesso, envie uma requisição POST para a API do AppSignal com os seguintes parâmetros de consulta na URL:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER'
O AppSignal notificará você se nenhum evento de finalização do monitor de processo cron for recebido dentro da duração máxima configurada do monitor de processo cron.
Iniciar monitor de processo cron
Enviar um evento de início do monitor de processo cron é totalmente opcional. Fazer isso permite medir a duração dos seus cron jobs.
Para notificar o AppSignal que um cron job começou, envie uma requisição POST para a API do AppSignal com os seguintes parâmetros de consulta na URL:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER' \
-d 'kind=start'
Enviando um digest
Ao enviar um início de monitor de processo cron, recomendamos enviar um digest para os eventos de início e de finalização. O digest é um valor arbitrário que é usado para correlacionar os eventos de início e finalização do monitor de processo cron. Deve ser o mesmo para os eventos de início e finalização, e deve ser único para cada par de eventos de início e finalização.
Enviar um digest é opcional, mas é altamente recomendado ao enviar um evento de início de monitor de processo cron, pois garante que os eventos de início e finalização sejam correlacionados corretamente.
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
... \
-d 'digest=abc123'
Enviando eventos de monitor de processo heartbeat
Monitores de processo heartbeat são usados para monitorar o tempo de atividade de um processo que deve ser executado continuamente, como uma aplicação de servidor ou um processador de jobs em background. O AppSignal esperará receber eventos de monitor de processo heartbeat continuamente e notificará você se nenhum evento de monitor de processo heartbeat for recebido dentro de sua duração máxima configurada.
Para enviar um evento de monitor de processo heartbeat para o AppSignal, envie uma requisição POST para a API do AppSignal com os seguintes parâmetros de consulta na URL:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/heartbeats' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER'