Norme sulla deprecazione degli agenti Cloud Logging e Monitoring

Questo documento descrive in dettaglio la policy di ritiro per i seguenti agenti di logging e monitoraggio e i relativi componenti lato client:

Questo documento non si applica a Ops Agent o a Google-Built OpenTelemetry Collector. Per informazioni sull'assistenza per questi agenti, vedi Orizzonti temporali di assistenza per Ops Agent e Google-Built OpenTelemetry Collector.

Deprecazione di una versione di rilascio

Supporto per le versioni di rilascio

Tutti gli agenti e i relativi componenti lato client seguono la convenzione di controllo delle versioni <MAJOR>.<MINOR>.<PATCH>. Ad esempio, stackdriver-agent 5.5.2. Una nuova release incrementa:

  • La versione PRINCIPALE quando si apportano modifiche incompatibili con le versioni precedenti,
  • La versione MINOR quando si aggiunge una funzionalità in modo retrocompatibile,
  • La versione PATCH quando si apportano correzioni di bug compatibili con le versioni precedenti.

Il supporto di una versione dell'agente significa che i bug negli agenti vengono sottoposti a debug e corretti su ciascuna delle piattaforme supportate. I clienti potrebbero dover eseguire l'upgrade del proprio agente all'ultima release secondaria della stessa versione principale per usufruire di eventuali correzioni di bug. Tuttavia, non sono tenuti a eseguire l'upgrade a una versione principale successiva dell'agente, che potrebbe contenere modifiche non compatibili con le versioni precedenti.

Se un problema di sicurezza o un bug critico rilevato in una delle versioni principali supportate esiste anche in altre versioni principali supportate, la correzione del bug viene eseguita su tutte le versioni principali supportate, a meno che la correzione non sia compatibile con le versioni precedenti. Le nuove funzionalità non verranno sottoposte a backporting.

Le modifiche compatibili con le versioni precedenti, incluse nuove funzionalità o correzioni di bug, vengono apportate alle versioni secondarie della versione principale più recente in qualsiasi momento. Le modifiche non compatibili con le versioni precedenti vengono incorporate nella release principale successiva.

Dismissione

La durata di qualsiasi versione principale di un agente Cloud Logging o Cloud Monitoring è di almeno 12 mesi. Una versione principale (ad es. la versione N) viene ritirata 12 mesi dopo il rilascio della versione principale successiva (ad es. la versione N+1). Il ritiro di una versione principale significa che non riceve ulteriori correzioni di bug o versioni secondarie. Significa anche che l'assistenza clienti non è più disponibile per quella versione. Una volta ritirata una versione, i file di installazione dell'agente per quella versione vengono rimossi e non sono disponibili per il download.

Le release successive dell'agente in cui viene aggiornata solo la versione secondaria non reimpostano il timer. La durata di qualsiasi versione secondaria segue la pianificazione del ritiro e della disattivazione della versione principale.

Non riceverai un annuncio di servizio obbligatorio (MSA) per ogni release. Puoi invece trovare la data di ritiro pianificata nelle pagine README dell'agente.

Quando un ambiente, ad esempio Amazon Elastic Compute Cloud (EC2), o un sistema operativo raggiunge la fine del ciclo di vita, anche il supporto dell'agente viene ritirato. Il ritiro effettivo avviene al termine dell'assistenza per l'ambiente o il sistema operativo, a meno che non sia già stata impostata una data di ritiro specifica per un agente. Per saperne di più, consulta la sezione Ritiro del supporto per ambienti, sistemi operativi e funzionalità di questa guida.

Piano di transizione per agenti e componenti esistenti

Le versioni degli agenti e dei componenti lato client esistenti prima di questo criterio di ritiro saranno disponibili e supportate almeno fino al 28 febbraio 2020. Tuttavia, le correzioni di bug non verranno eseguite per queste release.

Per visualizzare le date di ritiro di altre versioni degli agenti e dei componenti, consulta la pagina README di ogni componente.

Ritiro del supporto per ambienti, sistemi operativi e funzionalità

Supporto di ambienti e sistemi operativi

Gli agenti Logging e Monitoring sono file binari che vengono installati negli ambienti client. Ogni agente supporta combinazioni diverse di ambiente e sistema operativo. Un esempio di combinazione è Amazon Linux su EC2.

Funzionalità supportate

Una funzionalità si riferisce a un'unità di funzionalità degli agenti che soddisfa un requisito, rappresenta una decisione di progettazione e/o fornisce una potenziale opzione di configurazione. Un esempio di funzionalità è il supporto per l'importazione di metriche per una risorsa monitorata.

Ritiro

Quando il supporto di un ambiente, un sistema operativo o una funzionalità viene ritirato, riceverai un MSA per annunciare il ritiro, incluso un link a queste norme di ritiro. L'MSA è associato alla versione principale dell'agente e al rilascio del componente. La data di ritiro dell'ambiente, del sistema operativo o della funzionalità è la stessa della data di ritiro della versione principale della release dell'agente. Questa versione principale è l'ultima a supportare l'ambiente, il sistema operativo o la funzionalità.

Dismissione

Quando il supporto per un ambiente, un sistema operativo o una funzionalità viene ritirato, non viene più fornita assistenza clienti per quell'ambiente, sistema operativo o funzionalità. Verrà inviato un MSA per annunciare il ritiro.