Guia para usar a API C SDK

O C SDK da New Relic monitora seu aplicativo e microsserviços para ajudá-lo a identificar e resolver problemas de desempenho. Aplicativo C executado a partir de um arquivo binário nativo compilado. Para monitor a transação, você deve instrumentar manualmente seu código adicionando métodos New Relic a ele.

Este guia ajuda você a decidir qual método usar. O código do método, os parâmetros obrigatórios e os exemplos residem na documentação C SDK da New Relic no GitHub.

Certifique-se de que sua personalização seja segura para threads

O C SDK oferece suporte à instrumentação de aplicativos multithread, mas deve ser inicializado antes da instrumentação de vários threads. Ao chamar qualquer uma das funções a seguir, certifique-se de que elas sejam called on the main thread antes de qualquer outra função do C SDK ser chamada:

• newrelic_configure_log
• newrelic_init

Monitor transação

Antes de instrumentar manualmente seu código para monitor a transação:

1. Verifique a compatibilidade e os requisitos do C SDK para seu aplicativo.
2. Certifique-se de estar usando a versão mais recente da biblioteca C SDK e atualize conforme necessário.

Métodos específicos de tempo usando segmentos

Se uma transação já estiver visível no New Relic, mas você não tiver dados suficientes sobre um método específico que foi chamado durante essa transação, você poderá instrumentar segmentos. Por exemplo, se você quiser cronometrar um método que possui lógica complexa, poderá criar um segmento para cada um dos métodos na transação.

Para instrumentar um método em uma transação existente, crie segmentos para qualquer um dos seguintes:

• Serviços externos
• Funções ou outros blocos arbitrários de código (usando segmentos personalizados)
• Armazenamentos de dados
• Consulta lenta trace (somente armazenamentos de dados SQL)

newrelic_start_datastore_segment()
newrelic_start_external_segment()
newrelic_start_segment()

Os segmentos são registrados na transação ativa. Ao adicionar um segmento a uma transação ativa, você precisa de acesso ao newrelic_txn_t* ou ponteiro de transação, retornado por newrelic_start_web_transaction() ou newrelic_start_non_web_transaction().

Aprimore os metadados de uma transação

Você pode gerenciar os metadados que a New Relic reporta para transação. Isto é útil quando você deseja um nível diferente de detalhe para sua transação. Por exemplo:

• Se você estiver enfrentando um problema de agrupamento métrico, poderá alterar os nomes padrão da sua transação para torná-los mais identificáveis.

• Se você deseja criar

  dashboards

  para sua transação, você pode adicionar um atributo personalizado.

Instrumentar chamadas para serviços externos

Use estes métodos para coletar dados sobre as conexões do seu aplicativo com outros aplicativos ou banco de dados:

Coletar ou log erros

O C SDK detecta erros automaticamente. Se você quiser alterar a forma como ele relata erros ao New Relic, altere a configuração do coletor de erros.

Envie dados personalizados do seu aplicativo

Para registrar dados personalizados com o C SDK, você pode usar qualquer um dos seguintes métodos:

• Custom events:

  Na New Relic, dados de eventos são um tipo de dados fundamental. Os dados do evento representam um registro de um único evento em um determinado momento. Isto é útil para visualizar ou consultar detalhes específicos.

• Custom event attributes:

  Para incluir metadados adicionais sobre o evento, você pode adicionar pares de valores principais (atributo personalizado) ao seu evento personalizado.

• Custom metrics:

  métrica de fração de tempo data é a medida estatística de dados que o New Relic agrega para que você possa visualizá-los na interface do usuário e mapeá-los. Normalmente, os dados métricos têm um período de retenção mais longo do que os dados de eventos.

// txn is a newrelic_txn_t*, created via newrelic_start_web_transaction
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");
newrelic_record_custom_event(txn, &custom_event);

// Example custom attributes:
newrelic_custom_event_t* custom_event=0;
custom_event = newrelic_create_custom_event("aTypeForYourEvent");

newrelic_custom_event_add_attribute_int(custom_event, "keya", 42);
newrelic_custom_event_add_attribute_long(custom_event, "keyb", 84);
newrelic_custom_event_add_attribute_double(custom_event, "keyc", 42.42);
newrelic_custom_event_add_attribute_string(custom_event, "keyd", "A string");

newrelic_record_custom_event(txn, &custom_event);

Aqui estão algumas maneiras de usar seus dados personalizados. Para obter detalhes de código e exemplos dessas opções, consulte a documentação global do New Relic no GitHub.

Monitor desktop browser performance

Para monitor o desempenho do browser de desktop para seu aplicativo, instale o agente do browser usando o método copiar/colar.

Alterar definições de configuração

Normalmente, as configurações padrão da configuração do seu aplicativo não precisam ser alteradas. No entanto, quando necessário, você pode ajustar algumas configurações. Para obter mais informações, consulte a documentação de configuração do C SDK.