Solução de problemas de erro na implantação da política de registros de mensagens

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

InvalidProtocol

Mensagem de erro

A implantação de um proxy de API pela IU do Edge ou pela API Edge Management falha com esta mensagem de erro:

Error Saving Revision revision_number
Invalid Protocol: invalid_protocol for Syslog handler in policy policy_name.

Exemplo de mensagem de erro

Error Saving Revision 4
Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.

Exemplo de captura de tela

Causa

A implantação da política MessageLogging poderá falhar com esse erro se o protocolo especificado no elemento <Protocol> não for válido. Os protocolos válidos são TCP e UDP. Para enviar mensagens syslog por TLS/SSL, apenas TCP é aceito.

Por exemplo, a implantação do proxy de API falhará com esse erro se você especificar HTTP no elemento <Protocol> da política MessageLogging, conforme mostrado abaixo:

<Protocol>HTTP</Protocol>

Diagnóstico

  1. Identifique a política MessageLogging em que o erro ocorreu. Você encontra essas informações na mensagem de erro. Por exemplo, no erro a seguir, o nome da política é LogToSyslog:

    Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
    
  2. Na falha da configuração da política MessageLogging verifique se o protocolo especificado no elemento <Protocol> é válido. Se houver um protocolo inválido especificado, essa é a causa do erro.

    Por exemplo, a política a seguir especifica um protocolo inválido.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <MessageLogging name="LogToSyslog">
      <Syslog>
        <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
        <Host>logs-01.loggly.com</Host>
        <Port>514</Port>
        <Protocol>HTTP</Protocol>
        <FormatMessage>true</FormatMessage>
      </Syslog>
      <logLevel>ALERT</logLevel>
    </MessageLogging>
    

    Como o protocolo definido no elemento <Protocol> é inválido, a implantação do proxy de API falha com o erro:

    Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
    

Resolução

Verifique se o protocolo definido no elemento <Protocol> da política MessageLogging é válido. O elemento <Protocol> é compatível com os seguintes valores:

  • TCP
  • UDP

Para corrigir o exemplo mostrado acima, defina um protocolo válido dentro do elemento <Protocol>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageLogging name="LogToSyslog">
  <Syslog>
    <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
    <Host>logs-01.loggly.com</Host>
    <Port>514</Port>
    <Protocol>TCP</Protocol>
    <FormatMessage>true</FormatMessage>
  </Syslog>
  <logLevel>ALERT</logLevel>
</MessageLogging>

InvalidPort

Mensagem de erro

A implantação de um proxy de API pela IU do Edge ou pela API Edge Management falha com esta mensagem de erro:

Error Saving Revision revision_number
Invalid Port: 0 for Syslog handler in policy policy_name.

Exemplo de mensagem de erro

Error Saving Revision 4
Invalid Port: 0 for Syslog handler in policy LogToSyslog.

Exemplo de captura de tela

Causa

A implantação da política MessageLogging poderá falhar com esse erro se o número da porta não for especificado no elemento <Port> ou se não for válido. O número da porta precisa ser um número inteiro maior que zero.

Por exemplo, se o elemento <Port> for declarado como mostrado abaixo, a implantação do proxy de API falhará:

<Port>0</Port>

Diagnóstico

  1. Identifique a política MessageLogging em que o erro ocorreu. Você encontra essas informações na mensagem de erro. Por exemplo, no erro a seguir, o nome da política é LogToSyslog:

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.
    
  2. Na política do MessageLogging com falha, verifique se um número de porta válido está especificado no elemento <Port>. Se o número da porta não for definido ou for inválido, essa é a causa do erro.

    Por exemplo, a política a seguir especifica um número de porta inválido:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <MessageLogging name="LogToSyslog">
      <Syslog>
        <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
        <Host>logs-01.loggly.com</Host>
        <Port>0</Port>
        <Protocol>TCP</Protocol>
        <FormatMessage>true</FormatMessage>
      </Syslog>
      <logLevel>ALERT</logLevel>
    </MessageLogging>
    

    Como o número da porta definido no elemento <Port> é inválido, a implantação do proxy da API falha com o erro:

    Invalid Port: 0 for Syslog handler in policy LogToSyslog.
    

Resolução

Verifique se um número de porta está definido no elemento <Port> da política MessageLogging. Precisa ser um número inteiro maior do que zero.

Para corrigir o exemplo mostrado acima, defina um número de porta válido no elemento <Protocol>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageLogging name="LogToSyslog">
  <Syslog>
    <Message>[3f509b58 tag="{organization.name}.{apiproxy.name}.{environment.name}"] Weather request for WOEID {request.queryparam.w}.</Message>
    <Host>logs-01.loggly.com</Host>
    <Port>514</Port>
    <Protocol>TCP</Protocol>
    <FormatMessage>true</FormatMessage>
  </Syslog>
  <logLevel>ALERT</logLevel>
</MessageLogging>