Configurare i log di Monitoraggio di Azure e raccogliere i dati di diagnostica per i messaggi B2B in App per la logica di Azure

Si applica a: App per la logica di Azure (A consumo)

Nota

Questo articolo si applica solo alle app per la logica A consumo. Per informazioni sul monitoraggio delle app per la logica Standard, vedere Abilitare o aprire Application Insights dopo la distribuzione per le app per la logica Standard.

Dopo aver configurato la comunicazione B2B tra partner commerciali nell'account di integrazione, tali partner possono scambiare messaggi usando protocolli, ad esempio AS2, X12 ed EDIFACT. Per verificare che questa comunicazione funzioni nel modo previsto, è possibile configurare i log di Monitoraggio di Azure per l'account di integrazione. Monitoraggio di Azure consente di monitorare gli ambienti cloud e locali per consentire una gestione semplificata della loro disponibilità e delle prestazioni. Usando i log di Monitoraggio di Azure, è possibile registrare e archiviare i dati relativi a dati ed eventi di runtime, ad esempio eventi di attivazione, eventi di esecuzione ed eventi di azione in un'area di lavoro Log Analytics. Per i messaggi, la registrazione raccoglie anche informazioni come:

• Conteggio e stato dei messaggi
• Stato degli acknowledgment
• Correlazioni tra messaggi e riconoscimenti
• Descrizione dettagliata degli errori

Monitoraggio di Azure consente di creare query di log che facilitano il rilevamento e l’esame di queste informazioni. Inoltre è possibile usare questi dati di diagnostica con altri servizi di Azure, come Archiviazione di Azure e Hub eventi di Azure.

Per configurare la registrazione per l'account di integrazione, installare la soluzione B2B di App per la logica nel portale di Azure. Questa soluzione fornisce informazioni aggregate per gli eventi di messaggistica B2B. Quindi, per abilitare la registrazione e la creazione di queste informazioni, configurare i log di Monitoraggio di Azure.

Questo articolo mostra come abilitare la registrazione di Monitoraggio di Azure per l'account di integrazione.

Nota

Questo articolo è stato aggiornato di recente in modo da usare il termine log di Monitoraggio di Azure anziché Log Analytics. I dati di log vengono comunque archiviati in un'area di lavoro Log Analytics e vengano ancora raccolti e analizzati dallo stesso servizio Log Analytics. Si sta procedendo a un aggiornamento della terminologia per riflettere meglio il ruolo dei log in Monitoraggio di Azure. Per informazioni dettagliate, vedere Modifiche della terminologia di Monitoraggio di Azure.

Prerequisiti

• Un'area di lavoro Log Analytics. Se non si dispone di un'area di lavoro Log Analytics, vedere Creare un'area di lavoro Log Analytics.

• Un'app per la logica configurata con la registrazione di Monitoraggio di Azure che invia tali informazioni a un'area di lavoro Log Analytics. Informazioni su come configurare i log di Monitoraggio di Azure per l'app per la logica.

• Un account di integrazione collegato all'app per la logica. Informazioni su come collegare l'account di integrazione all'app per la logica.

Installare la soluzione di App per la logica B2B

Per permettere ai log di Monitoraggio di Azure di tenere traccia dei messaggi B2B per l'app per la logica, aggiungere la soluzione App per la logica B2B all’area di lavoro Log Analytics.

1. Nella casella di ricerca del portale di Azure immettere log analytics workspaces e selezionare Aree di lavoro Log Analytics.

   

2. In Aree di lavoro Log Analytics selezionare l'area di lavoro.

   

3. Nel riquadro Panoramica, in Introduzione a Log Analytics> Configurare soluzioni di monitoraggio, selezionare Visualizza soluzioni.

   

4. Nel riquadro Panoramica selezionare Aggiungi.

   

5. Appena si apre Marketplace, nella casella di ricerca immettere logic apps b2b e selezionare App per la logica B2B.

   

6. Nel riquadro della descrizione della soluzione selezionare Crea.

   

7. Rivedere e confermare l'area di lavoro Log Analytics in cui si vuole installare la soluzione e quindi selezionare di nuovo Crea.

   

   Dopo che Azure ha distribuito la soluzione nel gruppo di risorse di Azure che contiene l'area di lavoro Log Analytics, la soluzione viene visualizzata nel riquadro di riepilogo dell'area di lavoro. Dopo l'elaborazione dei messaggi B2B, il numero di messaggi in questo riquadro viene aggiornato.

   

Configurare i log di Monitoraggio di Azure

È possibile abilitare la registrazione di Monitoraggio di Azure direttamente dall'account di integrazione.

1. Nel portale di Azure trovare e selezionare l'account di integrazione.

   

2. Nel menu Account di integrazione, in Monitoraggio, selezionare Impostazioni di diagnostica. Selezionare Aggiungi impostazione di diagnostica.

   

3. Per creare l'impostazione, seguire questa procedura:

   1. Specificare un nome per l'impostazione.

   2. Selezionare Invia a Log Analytics.

   3. Per Sottoscrizione, selezionare la sottoscrizione di Azure associata all'area di lavoro Log Analytics.

   4. Per Area di lavoro Log Analytics selezionare l'area di lavoro da usare.

   5. In Log selezionare la categoria IntegrationAccountTrackingEvents, che specifica la categoria di eventi da registrare.

   6. Al termine, seleziona Salva.

   Ad esempio:

   

Visualizzare lo stato dei messaggi

Dopo l'esecuzione dell’app per la logica, è possibile visualizzare lo stato e i dati relativi a tali messaggi nell'area di lavoro Log Analytics.

1. Nella casella di ricerca del portale di Azure trovare e aprire l'area di lavoro Log Analytics.

2. Nel menu dell'area di lavoro selezionare Riepilogo dell'area di lavoro>App per la logica B2B.

   

   Nota

   Se il riquadro App per la logica B2B non mostra immediatamente i risultati dopo un'esecuzione, provare a selezionare Aggiorna o attendere un breve periodo di tempo prima di riprovare.

   Per impostazione predefinita, il riquadro App per la logica B2B visualizza i dati relativi a un solo giorno. Per modificare l'ambito dei dati e impostarlo su un intervallo diverso, scegliere il controllo dell'ambito nella parte superiore della pagina:

   

3. Quando viene aperto il dashboard con lo stato dei messaggi, è possibile visualizzare altri dettagli per un tipo di messaggio specifico, con i dati relativi a un solo giorno. Selezionare il riquadro AS2, X12 o EDIFACT.

   

   Un elenco di messaggi viene visualizzato per il riquadro scelto. Ecco, ad esempio, come può risultare un elenco di messaggi AS2:

   

   Per altre informazioni sulle proprietà di ogni tipo di messaggio, vedere queste descrizioni delle proprietà dei messaggi:

   • Proprietà dei messaggi AS2
   • Proprietà dei messaggi X12
   • Proprietà dei messaggi EDIFACT

Descrizioni delle proprietà e formati di nome per i messaggi AS2, X12 ed EDIFACT

Per ogni tipo di messaggio, di seguito sono elencate le descrizioni delle proprietà e i formati dei nomi per i file di messaggi scaricati.

Descrizioni delle proprietà dei messaggi AS2

Ecco le descrizioni delle proprietà per ogni messaggio AS2.

Proprietà	Descrizione
Mittente	Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo AS2
Ricevitore	Partner host specificato in Impostazioni di ricezione o partner guest specificato in Impostazioni di invio di un accordo AS2
App per la logica	App per la logica in cui sono configurate le azioni AS2
Stato	Stato dei messaggi AS2 Operazione completata = ricevuto o inviato un messaggio AS2 valido. Non sono configurate notifiche sulla ricezione del messaggio. Operazione completata = ricevuto o inviato un messaggio AS2 valido. La notifica sulla ricezione del messaggio è stata configurata e ricevuta o è stata inviata. Operazione non riuscita = ricevuto un messaggio AS2 non valido. Non sono configurate notifiche sulla ricezione del messaggio. In sospeso = ricevuto o inviato un messaggio AS2 valido. La notifica sulla ricezione del messaggio è stata configurata ed è prevista.
ACK	Stato dei messaggi di notifica sulla ricezione del messaggio Accettato = ricevuto o inviato un messaggio di notifica sulla ricezione del messaggio positivo. In sospeso = in attesa di ricevere o inviare un messaggio di notifica sulla ricezione del messaggio. Rifiutato = ricevuto o inviato un messaggio di notifica sulla ricezione del messaggio negativo. Non richiesto = notifica sulla ricezione del messaggio non configurata nell'accordo.
Direzione	Direzione dei messaggi AS2
ID tracciabilità	ID che correla tutti i trigger e le azioni in un'app per la logica
ID messaggio	ID del messaggio AS2 dalle intestazioni del messaggio AS2
Timestamp:	Ora in cui l'azione AS2 ha elaborato il messaggio

Descrizioni delle proprietà dei messaggi X12

Ecco le descrizioni delle proprietà per ogni messaggio X12.

Proprietà	Descrizione
Mittente	Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo X12
Ricevitore	Partner host specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo X12
App per la logica	App per la logica in cui sono configurate le azioni X12
Stato	Stato dei messaggi X12 Operazione completata = ricevuto o inviato un messaggio X12 valido. Non sono configurati ack funzionali. Operazione completata = ricevuto o inviato un messaggio X12 valido. L'ack funzionale è stato configurato e ricevuto o inviato. Operazione non riuscita = ricevuto o inviato un messaggio X12 non valido. In sospeso = ricevuto o inviato un messaggio X12 valido. L'ack funzionale è stato configurato ed è previsto.
ACK	Stato ACK funzionale (997) Accettato = ricevuto o inviato un ack funzionale positivo. Rifiutato = ricevuto o inviato un ack funzionale negativo. In sospeso = in attesa di un ack funzionale non ricevuto. In sospeso = ack funzionale generato, ma impossibile inviarlo al partner. Non richiesto = ack funzionale non configurato.
Direzione	Direzione dei messaggi X12
ID tracciabilità	ID che correla tutti i trigger e le azioni in un'app per la logica
Tipo di messaggio	Tipo di messaggio EDI X12
ICN	Numero di controllo interscambio del messaggio X12
TSCN	Numero di controllo del set di transazioni del messaggio X12
Timestamp:	Ora in cui l'azione X12 ha elaborato il messaggio

Descrizioni delle proprietà dei messaggi EDIFACT

Ecco le descrizioni delle proprietà per ogni messaggio EDIFACT.

Proprietà	Descrizione
Mittente	Partner guest specificato in Impostazioni di ricezione o partner host specificato in Impostazioni di invio di un accordo EDIFACT
Ricevitore	Partner host specificato in Impostazioni di ricezione o partner guest specificato in Impostazioni di invio di un accordo EDIFACT
App per la logica	App per la logica in cui sono configurate le azioni EDIFACT
Stato	Stato dei messaggi EDIFACT Operazione completata = ricevuto o inviato un messaggio EDIFACT valido. Non sono configurati ack funzionali. Operazione completata = ricevuto o inviato un messaggio EDIFACT valido. L'ack funzionale è stato configurato e ricevuto o inviato. Operazione non riuscita = ricevuto o inviato un messaggio EDIFACT non valido In sospeso = ricevuto o inviato un messaggio EDIFACT valido. L'ack funzionale è stato configurato ed è previsto.
ACK	Stato Ack funzionale (CONTRL) Accettato = ricevuto o inviato un ack funzionale positivo. Rifiutato = ricevuto o inviato un ack funzionale negativo. In sospeso = in attesa di un ack funzionale non ricevuto. In sospeso = ack funzionale generato, ma impossibile inviarlo al partner. Non richiesto = ack funzionale non configurato.
Direzione	Direzione dei messaggi EDIFACT
ID tracciabilità	ID che correla tutti i trigger e le azioni in un'app per la logica
Tipo di messaggio	Tipo di messaggio EDIFACT
ICN	Numero di controllo interscambio del messaggio EDIFACT
TSCN	Numero di controllo del set di transazioni del messaggio EDIFACT
Timestamp:	Ora in cui l'azione EDIFACT ha elaborato il messaggio

Passaggi successivi

• Creare query di monitoraggio e rilevamento