Sintaxe
newrelic.agent.set_error_group_callback(callback_function(exception, transaction_data))
Este método permite que grupos de erros na Errors Inbox sejam definidos para um identificador específico (ou "impressão digital").
Requisitos
Agente Python versão 8.8.0 ou superior.
Descrição
Este endpoint recebe uma única entrada, um retorno de chamada, que é usado para registrar grupos de erros. Esse retorno de chamada é definido pelo cliente e deve aceitar a exceção que acionou a APInotice_error
do agente. Para cancelar essa configuração, chame a API novamente e defina o retorno de chamada como None
.
Parâmetro para set_error_group_callback
Parâmetro | Descrição |
---|---|
função que pode ser chamada | Obrigatório. A função de retorno de chamada que você deseja definir. Use |
Instância do aplicativo | Opcional. Se uma instância do aplicativo não for fornecida, a função verificará a instância do aplicativo ativada. |
Parâmetro para função de retorno de chamada definida pelo cliente
Parâmetro | Descrição |
---|---|
Exceção de tempo de execução | Obrigatório. Esta seria a exceção de tempo de execução que acionou a API |
dicionário | Obrigatório. Um dicionário de dados de transação capturados pelo agente Python. |
Valores de retorno
Quando bem-sucedida, a API adicionará uma string representando o nome do grupo de erros desejado como um atributo do agente.
Se não tiver êxito, a API não adicionará error.group.name
como um atributo do agente.
Exemplo de uso
Definir retorno de chamada do grupo de erros
Um exemplo de uso de set_error_group_callback
:
def customer_callback(exc, data): if isinstance(exc, ValueError): return "group1"
def some_other_function(): try: raise ValueError("Oh no!") except Exception: newrelic.agent.notice_error()
def example_function(customer_callback): try: newrelic.agent.set_error_group_callback(customer_callback) some_other_function() finally: newrelic.agent.set_error_group_callback(None)