Questo documento descrive le norme sul ritiro per i seguenti agenti di Logging e Monitoring e dei relativi componenti lato client:
- Ops Agent
- Agente Cloud Logging legacy
- Agente Cloud Monitoring legacy
- Agente Stackdriver Metadata
- Heapster (per GKE versione 1.15 e precedenti)
- Integrazione di Cloud Monitoring-Prometheus
Ritirare una versione di release
Supporto delle versioni di release
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. Arricchimento di una nuova release:
- La versione MAJOR quando apporti modifiche non compatibili con le versioni precedenti.
- La versione MINOR quando si aggiunge la funzionalità in modo compatibile con le versioni precedenti,
- La versione PATCH in caso di correzioni di bug compatibili con le versioni precedenti.
Il supporto di una versione dell'agente comporta il debug e la correzione dei bug negli agenti su ciascuna delle piattaforme supportate. I clienti potrebbero dover eseguire l'upgrade del proprio agente alla release secondaria più recente della stessa versione principale per sfruttare eventuali correzioni di bug. Tuttavia, non è necessario eseguire l'upgrade a una versione principale successiva dell'agente, che potrebbe contenere modifiche incompatibili 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 sottoposta a backport in tutte le versioni principali supportate, a meno che la correzione non sia compatibile con le versioni precedenti. Non verrà eseguito il backporting delle nuove funzionalità.
Le modifiche compatibili con le versioni precedenti, incluse nuove funzionalità o correzioni di bug, possono essere rilasciate in qualsiasi momento alle release minori della versione principale più recente. Le modifiche incompatibili con le versioni precedenti vengono incluse nella prossima release principale.
Disattivazione
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 dismessa 12 mesi dopo il rilascio della successiva versione principale (ad es. la versione N+1). Se disattivi una versione principale, questa non riceverà ulteriori correzioni di bug o release di minore entità. Ciò significa inoltre che l'assistenza clienti non è più disponibile per quella versione. Una volta che una versione viene dismessa, i file del programma di installazione dell'agente per quella versione vengono rimossi e non sono disponibili per il download.
Le successive release dell'agente in cui viene aggiornata solo la versione secondaria non reimpostano l'orologio. La durata di qualsiasi versione secondaria segue la pianificazione del ritiro e del ritiro 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 degli agenti viene deprecato. La dismissione effettiva avviene al termine del supporto per l'ambiente o il sistema operativo, a meno che non sia già stata impostata una data di dismissione specifica per un agente. Per ulteriori informazioni, 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 sul ritiro saranno disponibili e supportate almeno fino al 28 febbraio 2020. Tuttavia, non verrà eseguito il backporting delle correzioni di bug per queste release.
Per vedere le date di ritiro per altre versioni degli agenti e dei componenti, consulta la pagina README per ogni componente.
Ritiro del supporto per ambienti, sistemi operativi e funzionalità
Supporto di ambienti e sistemi operativi
Gli agenti Logging e Monitoring sono programmi binari installati negli ambienti client. Ciascun agente supporta combinazioni di ambienti e sistemi operativi diversi. Una combinazione di esempio è Amazon Linux su EC2.
Supporto delle funzionalità
Una caratteristica è un'unità di funzionalità degli agenti che soddisfa un requisito, rappresenta una decisione di progettazione e/o fornisce una potenziale opzione di configurazione. Una funzionalità di esempio è il supporto per l'importazione di metriche per una risorsa monitorata.
Ritiro
Quando il supporto per un ambiente, un sistema operativo o una funzionalità viene deprecato, riceverai un MSA per annunciare il ritiro, che include un link a queste norme relative al ritiro. L'MSA è legato alla versione principale dell'agente e alla release del componente. La data di ritiro dell'ambiente, del sistema operativo o della funzionalità corrisponde a quella della versione principale della release dell'agente. La versione principale è l'ultima versione principale che supporta l'ambiente, il sistema operativo o la funzionalità.
Disattivazione
Quando l'assistenza per un ambiente, un sistema operativo o una funzionalità viene dismessa, l'assistenza clienti non viene più fornita per tale ambiente, sistema operativo o funzionalità. Verrà inviato un MSA per annunciare il ritiro.