Risoluzione degli errori di deployment dei criteri di Logging dei messaggi

Stai visualizzando la documentazione di Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.

Questa guida pratica per la risoluzione dei problemi è stata utile? Contattaci facendo clic su Invia feedback .

InvalidProtocol

Messaggio di errore

Il deployment di un proxy API tramite l'API o la UI di Apigee non va a buon fine e genera questo messaggio di errore:

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

Esempio di messaggio di errore

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

Screenshot di esempio

Causa

Il deployment del criterio MessageLogging può non riuscire con questo errore se il protocollo specificato nell'elemento <Protocol> non è valido. I protocolli validi sono TCP e UDP. Per l'invio di messaggi syslog tramite TLS/SSL, è supportato solo il protocollo TCP.

Ad esempio, il deployment del proxy API non va a buon fine con questo errore se specifichi HTTP nell'elemento <Protocol> del criterio MessageLogging, come illustrato di seguito:

<Protocol>HTTP</Protocol>

Diagnosi

1. Identifica il criterio MessageLogging in cui si è verificato l'errore. Puoi trovare queste informazioni nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è LogToSyslog:

   Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
   

2. Nella configurazione dei criteri di MessageLogging non riuscita, controlla se il protocollo specificato all'interno dell'elemento <Protocol> è valido. Se è stato specificato un protocollo non valido, questa è la causa dell'errore.

   Ad esempio, il seguente criterio specifica un protocollo non valido.

   <?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>
   

   Poiché il protocollo definito all'interno dell'elemento <Protocol> non è valido, il deployment del proxy API non va a buon fine e viene restituito l'errore:

   Invalid Protocol: HTTP for Syslog handler in policy LogToSyslog.
   

Risoluzione

Assicurati che il protocollo definito all'interno dell'elemento <Protocol> del criterio MessageLogging sia valido. L'elemento <Protocol> supporta i seguenti valori:

• TCP
• UDP

Per correggere l'esempio mostrato sopra, definisci un protocollo valido nell'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

Messaggio di errore

Il deployment di un proxy API tramite l'API o la UI di Apigee non va a buon fine e genera questo messaggio di errore:

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

Esempio di messaggio di errore

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

Screenshot di esempio

Causa

Il deployment del criterio MessageLogging può non riuscire con questo errore se il numero di porta non è specificato all'interno dell'elemento <Port> o se non è valido. Il numero di porta deve essere un numero intero maggiore di zero.

Ad esempio, se l'elemento <Port> viene dichiarato come mostrato di seguito, il deployment del proxy API non va a buon fine:

<Port>0</Port>

Diagnosi

1. Identifica il criterio MessageLogging in cui si è verificato l'errore. Puoi trovare queste informazioni nel messaggio di errore. Ad esempio, nell'errore seguente, il nome del criterio è LogToSyslog:

   Invalid Port: 0 for Syslog handler in policy LogToSyslog.
   

2. Nel criterio MessageLogging non riuscito, controlla se è stato specificato un numero di porta valido all'interno dell'elemento <Port>. Se il numero di porta non è definito o non è valido, è questa la causa dell'errore.

   Ad esempio, il seguente criterio specifica un numero di porta non valido:

   <?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>
   

   Poiché il numero di porta definito all'interno dell'elemento <Port> non è valido, il deployment del proxy API non va a buon fine e viene restituito l'errore:

   Invalid Port: 0 for Syslog handler in policy LogToSyslog.
   

Risoluzione

Assicurati che sia definito un numero di porta all'interno dell'elemento <Port> del criterio MessageLogging. Deve essere un numero intero maggiore di zero.

Per correggere l'esempio mostrato sopra, definisci un numero di porta valido all'interno dell'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>