newrelic_set_appname (API do agente PHP)

Sintaxe

newrelic_set_appname(string $name)
newrelic_set_appname(string $name, string $license[, bool $xmit])

Define o nome do aplicativo New Relic, que controla a agregação de dados.

Requisitos

Versão do agente 3.1.5.111 ou superior.

Descrição

Defina o nome do aplicativo New Relic, que a interface do New Relic usa para conectar seus dados ao aplicativo correto.

O método recomendado e preferido para definir o nome do aplicativo New Relic é usar configurações INI globais ou por diretório para associar seu aplicativo ao nome desejado no início da execução.

Se você não puder editar o arquivo de configuração do seu agente (por exemplo, muitos ambientes de hospedagem compartilhada não permitem editar arquivos de configuração), a chamada de API newrelic_set_appname poderá ser usada para configurar o nome do aplicativo, chave de licença(opcional, se você usar várias contas ) e um sinalizador verdadeiro/falso (opcional, para determinar se os dados registrados anteriormente devem ser mantidos ou descartados). Para garantir a continuidade máxima trace do APM, chame isso o mais cedo possível. Esta chamada de API descartará todos os dados de transação atuais e iniciará uma nova transação após ser reconectada ao nome do aplicativo fornecido.

Para outras opções de nomenclatura de aplicativos, consulte Nomeie seu aplicativo PHP. Quando possível, são recomendadas soluções baseadas em INI.

Comportamento de chamada e localização

É altamente recomendável que você chame essa função o mais rápido possível após iniciar o monitoramento do seu aplicativo e em uma stack de chamadas o mais rasa possível. Os aplicativos são entidades distintas no APM e, quando você altera o nome de um aplicativo, não há nada que vincule os dados dos dois nomes de aplicativos. O uso da função newrelic_set_appname pode levar à descontinuidade do seu rastreamento da transação. Em outras palavras, novas transações são reportadas ao novo nome do aplicativo e não há nada que as vincule aos dados conectados ao nome do aplicativo antigo.

Este método deve ser chamado uma vez, pois cada chamada à API (mesmo com o mesmo nome do aplicativo) fará com que os dados da transação atual sejam descartados e leve a uma maior descontinuidade no rastreamento da transação.

Parâmetro

function newrelic_set_appname(string $name) : bool

function newrelic_set_appname(string $name, string $license, bool $xmit) : bool

Valores de retorno

Retorna true se o nome do aplicativo foi alterado com sucesso ou false caso contrário.

Exemplos

Defina um único nome de aplicativo

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1");
    }
    ...
}

Defina dois nomes de aplicativos

Este exemplo define vários nomes de aplicativos:

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1;App2");
    }
    ...
}

Defina o nome do aplicativo e a chave de licença

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890");
    }
    ...
}

Defina o nome do aplicativo e mantenha os dados anteriores

Este exemplo define um nome de aplicativo e mantém os dados existentes, mas não altera o chave de licença:

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "", true);
    }
    ...
}

Defina o nome do aplicativo e a chave de licença e mantenha os dados anteriores

Este exemplo define o nome do aplicativo e a chave de licença e mantém os dados existentes:

function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_set_appname("App1", "01234567890abcde01234567890abcde01234567890", true);
    }
    ...
}