

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Inserisci i parametri di Prometheus nell'area di lavoro
<a name="AMP-onboard-ingest-metrics"></a>

Un modo per inserire i parametri consiste nell'utilizzare un *agente* Prometheus autonomo (un'istanza Prometheus in esecuzione in modalità agente) per importare i parametri dal cluster e inoltrarli al servizio gestito da Amazon per Prometheus per l'archiviazione e il monitoraggio. Questa sezione spiega come configurare l'importazione dei parametri nell'area di lavoro del servizio gestito da Amazon per Prometheus da Amazon EKS configurando una nuova istanza dell'agente Prometheus utilizzando Helm.

Per generare metriche in Amazon EKS, come Kubernetes o metriche a livello di nodo, puoi utilizzare i componenti aggiuntivi della community di Amazon EKS. Per ulteriori informazioni, consulta la sezione [Componenti aggiuntivi disponibili per la community](https://docs.aws.amazon.com/eks/latest/userguide/community-addons.html#_available_community_add_ons) nella *Guida per l'utente di Amazon EKS*.

Per informazioni su altri modi per inserire dati nel servizio gestito da Amazon per Prometheus, incluso come proteggere i parametri e creare parametri ad alta disponibilità, consulta [Inserisci i parametri nel tuo spazio di lavoro Amazon Managed Service for Prometheus](AMP-ingest-methods.md).

**Nota**  
Le metriche inserite in un'area di lavoro vengono archiviate per 150 giorni per impostazione predefinita e vengono quindi eliminate automaticamente. Puoi modificare il periodo di conservazione configurando l'area di lavoro fino a un massimo di 1095 giorni (tre anni). Per ulteriori informazioni, consulta [Configurare](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-workspace-configuration.html) l'area di lavoro.

Le istruzioni in questa sezione ti consentono di iniziare rapidamente a utilizzare il servizio gestito da Amazon per Prometheus. Si presuppone che tu abbia già [creato uno](AMP-onboard-create-workspace.md) spazio di lavoro. In questa sezione, configuri un nuovo server Prometheus in un cluster Amazon EKS e il nuovo server utilizza una configurazione predefinita per fungere da agente per inviare metriche ad Amazon Managed Service for Prometheus. Questo metodo ha i seguenti prerequisiti:
+ È necessario disporre di un cluster Amazon EKS da cui il nuovo server Prometheus raccoglierà i parametri.
+ Nel cluster Amazon EKS deve essere installato un [driver Amazon EBS CSI](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html) (richiesto da Helm).
+ È necessario utilizzare Helm CLI 3.0 o versione successiva.
+ È necessario utilizzare un computer Linux o macOS per eseguire i passaggi descritti nelle sezioni seguenti.

## Fase 1: aggiunta di nuovi repository del grafico Helm
<a name="AMP-quick-new-Prometheus-HelmRepo"></a>

Immetti i seguenti comandi per aggiungere il nuovo repository del grafico Helm. Per ulteriori informazioni su questi comandi, consulta [Repository Helm](https://helm.sh/docs/helm/helm_repo/).

```
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update
```

## Fase 2: creazione di un namespace Prometheus.
<a name="AMP-quick-new-Prometheus-namespace"></a>

Immetti il seguente comando per creare un namespace Prometheus per il server Prometheus e altri componenti di monitoraggio. Sostituiscilo *prometheus-agent-namespace* con il nome che desideri per questo namespace.

```
kubectl create namespace prometheus-agent-namespace
```

## Fase 3: configurazione dei ruoli IAM per gli account del servizio.
<a name="AMP-quick-new-Prometheus-IRSA"></a>

Per questo metodo di inserimento, è necessario utilizzare i ruoli IAM per gli account del servizio nel cluster Amazon EKS in cui l'agente Prometheus è in esecuzione.

Grazie ai ruoli IAM per gli account del servizio, è possibile associare un ruolo IAM a un account del servizio Kubernetes. Questo account di servizio può quindi fornire AWS le autorizzazioni ai contenitori in qualsiasi pod che utilizza quell'account di servizio. Per ulteriori informazioni, consulta [Ruoli IAM per gli account del servizio](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html).

Se non hai già impostato questi ruoli, segui le istruzioni riportate in [Configura i ruoli di servizio per l'acquisizione di parametri dai cluster Amazon EKS.](set-up-irsa.md#set-up-irsa-ingest) per configurare i ruoli. Le istruzioni contenute in quella sezione richiedono l'uso di `eksctl`. Per ulteriori informazioni, consulta [Nozioni di base su Amazon Elastic Kubernetes Service – `eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html). 

**Nota**  
Quando non sei su EKS o utilizzi solo la chiave di accesso AWS e la chiave segreta per accedere ad Amazon Managed Service for Prometheus, non puoi usare il SigV4 basato. `EKS-IAM-ROLE`

## Fase 4: configurazione del nuovo server e avvio dell'importazione dei parametri
<a name="AMP-quick-ingest-metrics-new-Prometheus-Helm"></a>

Per installare il nuovo agente Prometheus e inviare i parametri alla tua area di lavoro del servizio gestito da Amazon per Prometheus, segui questi passaggi.

**Per installare un nuovo agente Prometheus e inviare parametri alla tua area di lavoro del servizio gestito da Amazon per Prometheus**

1. Utilizza un editor di testo per creare un file denominato `my_prometheus_values_yaml` con il seguente contenuto.
   + Sostituisci *IAM\$1PROXY\$1PROMETHEUS\$1ROLE\$1ARN* con l'ARN del file in **amp-iamproxy-ingest-role**cui hai creato. [Configura i ruoli di servizio per l'acquisizione di parametri dai cluster Amazon EKS.](set-up-irsa.md#set-up-irsa-ingest)
   + *WORKSPACE\$1ID*Sostituiscilo con l'ID del tuo spazio di lavoro Amazon Managed Service for Prometheus.
   + Sostituisci *REGION* con la regione del tuo spazio di lavoro Amazon Managed Service for Prometheus.

   ```
   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500
   ```

1. Inserisci il seguente comando per creare il server di Prometheus.
   + Sostituisci *prometheus-chart-name* con il nome della versione di Prometheus.
   + *prometheus-agent-namespace*Sostituiscilo con il nome del tuo namespace Prometheus.

   ```
   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-agent-namespace \
   -f my_prometheus_values_yaml
   ```