Norme sulla deprecazione degli agenti Cloud Logging e Monitoring

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

Ritirare una versione di release

Supporto delle 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. Arricchimento di una nuova release:

  • 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 in caso di 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 viene rilevato in una delle versioni principali supportate esiste anche in altre versioni principali supportate, la correzione del bug viene riportata 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, incluse nuove funzionalità o correzioni di bug, vengono impostate come minori la 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 è pari a almeno 12 mesi. Una versione principale (ad es. la versione N) viene dismessa dopo 12 mesi dopo il rilascio della successiva versione principale (ad es. la versione N+1). Disattivazione una versione principale significa che non riceve ulteriori correzioni di bug o nuove versioni. 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 dismissione pianificata nel file README dell'agente pagine.

Ad esempio, quando un ambiente è Amazon Elastic Compute Cloud (EC2) o il sistema operativo raggiunge la fine del ciclo di vita, anche l'assistenza dell'agente è stata ritirata. La dismissione effettiva avviene quando il supporto per l'ambiente termina il sistema, a meno che non sia già stata impostata una data di dismissione specifica per un dell'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, non verrà eseguito il backporting delle correzioni di bug per queste release.

Per vedere 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 binari che vengono installati negli ambienti client. Ogni agente supporta ambienti e sistemi operativi diversi combinazioni. Un esempio di combinazione è Amazon Linux su EC2.

Funzionalità supportate

Una caratteristica è l'unità di funzionalità degli agenti che soddisfa un requisito, rappresenta una decisione di progettazione e/o fornisce una 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 deprecato, riceveranno un MSA per annunciare il ritiro, che include un link al norme sul ritiro. L'MSA è legato alla versione principale dell'agente e nella release del componente. La data di ritiro dell'ambiente, del sistema operativo o della funzionalità è la uguale 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 per un ambiente, un sistema operativo o una funzionalità è dismesso, non viene più fornita assistenza clienti per questo ambiente sistema operativo o funzionalità. Verrà inviato un MSA per annunciare il e il ritiro delle risorse.