Condividi tramite


Panoramica dell'agente di inserimento

Un agente di inserimento carica i dati in un prodotto Dati analitici operatori di Azure. È disponibile un agente di inserimento denominato agente di inserimento di Azure Operator Insights che è possibile installare in una macchina virtuale Linux per caricare i dati dalla rete. Questo agente di inserimento supporta il caricamento:

  • Flussi di dati EDR (Mobile Content Cloud, Event Data Record) (EDR) affermati.
  • File archiviati in un server SFTP.

La combinazione di diversi tipi di origine in un'istanza dell'agente non è consigliata nell'ambiente di produzione, ma è supportata per le prove e i test del lab.

Panoramica dell'origine EDR MCC

Un agente di inserimento configurato con un'origine MCC EDR è progettato per l'uso con un McC (Affirmed Networks Mobile Content Cloud). Inserisce i record dei dati degli eventi (EDR) dagli elementi di rete MCC e li carica in Azure Operator Insights. Per altre informazioni, vedere Quality of Experience - Affirmed MCC Data Product.To learn more, see Quality of Experience - Affirmed MCC Data Product.To learn more, see Quality of Experience - Affirmed MCC Data Product.

Panoramica dell'origine pull SFTP

Un agente di inserimento configurato con un'origine pull SFTP raccoglie i file da uno o più server SFTP e li carica in Azure Operator Insights.

Origini file

Un agente di inserimento raccoglie i file dalle pipeline di inserimento configurate . Una pipeline include i dettagli del server SFTP, i file da raccogliere e come gestire tali file.

Ad esempio, un singolo server SFTP potrebbe avere log, file CSV e file di testo. È possibile configurare ogni tipo di file come pipeline di inserimento separata. Per ogni pipeline di inserimento, è possibile specificare la directory da cui raccogliere i file (facoltativamente inclusi o esclusi file specifici in base ai percorsi di file), con quale frequenza raccogliere file e altre opzioni. Per informazioni dettagliate sulle opzioni disponibili, vedere Informazioni di riferimento sulla configurazione per l'agente di inserimento di Azure Operator Insights.

Le pipeline di inserimento presentano le restrizioni seguenti:

  • Non devono sovrapporsi, vale a dire che non devono raccogliere gli stessi file dagli stessi server.
  • È necessario configurare ogni pipeline in un solo agente. Se si configura una pipeline su più agenti, Azure Operator Insights riceve dati duplicati.

Elaborazione di file

L'agente di inserimento carica i file in Azure Operator Insights durante le esecuzioni di caricamento pianificate. La frequenza di queste esecuzioni viene definita nella configurazione della pipeline. Ogni esecuzione di caricamento carica i file in base alla configurazione della pipeline:

  • I percorsi dei file e le espressioni regolari per includere ed escludere i file specificano i file da caricare.
  • Il tempo di regolamento esclude i file modificati per ultimo entro questo periodo da qualsiasi caricamento. Ad esempio, se l'esecuzione del caricamento inizia alle 05:30 e il tempo di regolamento è di 60 secondi (un minuto), l'esecuzione del caricamento carica solo i file modificati prima delle 05:29.
  • L'esclusione prima dell'ora (se impostata) esclude i file dell'ultima modifica prima della data e dell'ora specificate.

L'agente di inserimento registra l'ultimo completamento di un'esecuzione di caricamento per un'origine file. Usa questo record per determinare quali file caricare durante l'esecuzione del caricamento successiva, usando il processo seguente:

  1. L'agente controlla l'ora dell'ultima registrazione.
  2. L'agente carica tutti i file modificati da quel momento. Si presuppone che abbia elaborato i file meno recenti durante un'esecuzione di caricamento precedente.
  3. Al termine dell'esecuzione del caricamento:
    • Se l'agente ha caricato tutti i file o gli unici errori non irreversibili, l'agente aggiorna il record. Il nuovo tempo si basa sull'ora di avvio dell'esecuzione del caricamento, meno il tempo di regolamento.
    • Se l'esecuzione del caricamento ha avuto errori riprovabili, ad esempio se la connessione ad Azure è stata persa, l'agente non aggiorna il record. L'aggiornamento del record consente all'agente di ritentare il caricamento per tutti i file che non sono stati caricati correttamente. I tentativi non duplicano i dati caricati in precedenza.

L'agente di inserimento è progettato per essere altamente affidabile e resiliente ai bassi livelli di interruzione della rete. Se si verifica un errore imprevisto, l'agente viene riavviato e fornisce di nuovo il servizio non appena viene eseguito. Dopo un riavvio, l'agente esegue un'esecuzione immediata di caricamento di recupero per tutte le origini file configurate. Torna quindi alla pianificazione configurata.

Autenticazione

L'agente di inserimento esegue l'autenticazione in due sistemi separati, con credenziali separate.

  • Per eseguire l'autenticazione all'endpoint di inserimento di un prodotto dati di Azure Operator Insights, l'agente ottiene un token di firma di accesso condiviso da un insieme di credenziali delle chiavi di Azure. L'agente esegue l'autenticazione a questo insieme di credenziali delle chiavi con un'identità gestita di Microsoft Entra ID o un'entità servizio e un certificato configurati al momento della creazione dell'agente.
  • Per eseguire l'autenticazione al server SFTP, l'agente può usare l'autenticazione tramite password o l'autenticazione con chiave SSH.

Per istruzioni di configurazione, vedere Configurare l'autenticazione in Azure, Preparare le macchine virtuali e Configurare il software dell'agente.

Passaggio successivo