Norme sulla deprecazione degli agenti Cloud Logging e Monitoring

Questo documento illustra i criteri di ritiro per i seguenti agenti di monitoraggio e logging e i relativi componenti lato client:

Ritiro di una versione di release

Supporto per le versioni di release

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

  • La versione MAJOR quando apporti modifiche non compatibili con le versioni precedenti.
  • La versione MINOR quando viene aggiunta una funzionalità in modo compatibile con le versioni precedenti.
  • La versione PATCH quando apporti correzioni di bug compatibili con le versioni precedenti.

Il supporto di una versione dell'agente significa che i bug degli agenti vengono sottoposti a debug e riparati su ciascuna delle piattaforme supportate. Per usufruire delle correzioni dei bug, i clienti potrebbero dover eseguire l'upgrade dell'agente all'ultima release minore della stessa versione principale. Tuttavia, non è necessario 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 è presente anche in altre versioni principali supportate, la correzione del bug viene sottoposta a backport a tutte le versioni principali supportate, a meno che la correzione non sia compatibile con le versioni precedenti. Le nuove funzionalità non verranno sottoposte a backport.

Le modifiche compatibili con le versioni precedenti, tra cui nuove funzionalità o correzioni di bug, vengono trasferite in qualsiasi momento alle release secondarie della versione principale più recente. 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 riceverà ulteriori correzioni di bug o release minori. Ciò 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 dell'agente successive in cui viene aggiornata solo la versione secondaria non reimpostano l'orologio. Il ciclo di vita di qualsiasi versione secondaria segue la pianificazione del ritiro e del ritiro della relativa 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 il fine del ciclo di vita, viene ritirato anche il supporto dell'agente. Il ritiro effettivo avviene al termine del supporto 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 riportate a queste release.

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

Ritiro del supporto per ambienti, sistemi operativi e funzionalità

Supporto di ambienti e sistemi operativi

Gli agenti Logging e Monitoring sono binari che vengono installati negli ambienti client. Ogni agente supporta diverse combinazioni 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 delle 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 sul ritiro. L'MSA è associato alla versione principale dell'agente e della release del componente. La data di ritiro dell'ambiente, del sistema operativo o della funzionalità corrisponde alla data di ritiro della versione principale della release dell'agente. Questa versione principale è l'ultima versione principale che supporta l'ambiente, il sistema operativo o la funzionalità.

Dismissione

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