Visualizzazione dell’attività di utenti specifici in Amazon Q Developer - Amazon Q Developer

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à.

Visualizzazione dell’attività di utenti specifici in Amazon Q Developer

È possibile configurare Amazon Q per raccogliere i dati di telemetria delle attività degli utenti dei singoli abbonati ad Amazon Q Developer della tua organizzazione e presentare tali informazioni in un report. Il report fornisce informazioni dettagliate su come utenti specifici utilizzano Amazon Q.

Amazon Q genera il report ogni giorno a mezzanotte (00:00) Coordinated Universal Time (UTC) e lo salva in un file CSV nel seguente percorso:

s3://bucketName/prefix/AWSLogs/accountId/QDeveloperLogs/by_user_analytic/region/year/month/day/00/accountId_by_user_analytic_timestamp.csv

Il file CSV è il seguente.

  • Ogni riga mostra un utente che ha interagito con Amazon Q quel giorno.

  • Ogni colonna mostra una metrica, come descritto in Metriche del report sull’attività degli utenti. Le metriche vengono calcolate in base alla telemetria dell’utente raccolta nel corso della giornata.

Se più di 1.000 utenti interagiscono con Amazon Q durante il giorno, Amazon Q suddivide i dati in diversi file CSV contenenti 1.000 utenti ciascuno e con i suffissi di part_1, part_2 e così via.

Nota

Quando abiliti i report sulle attività degli utenti, Amazon Q raccoglie i dati di telemetria indipendentemente da come uno sviluppatore ha configurato l’impostazione Consenti ad Amazon Q di inviare i dati di utilizzo ad AWS nel proprio IDE. Questa impostazione controlla se la telemetria può essere utilizzata dalla societàAWS e non dalla tua organizzazione. Per ulteriori informazioni su questa impostazione, consulta Disattivazione della condivisione della telemetria lato client.

Utilizza le seguenti istruzioni per abilitare i report sulle attività degli utenti.

Prerequisito

Crea un bucket Amazon S3 per contenere il file CSV del report sull’attività degli utenti. Il bucket deve:

  • Sii nella AWS regione in cui è stato installato il profilo Amazon Q Developer. Questo profilo è stato installato quando hai sottoscritto per la prima volta gli utenti della forza lavoro del Centro identità IAM ad Amazon Q Developer Pro. Per ulteriori informazioni su questo profilo e sulle Regioni in cui è supportato, consulta Cos’è il profilo di Amazon Q Developer? e Regioni supportate per la console Q Developer e il profilo Q Developer.

  • Accedi all' AWS account a cui gli utenti sono abbonati. Se gli utenti sono abbonati a più account AWS , devi creare dei bucket in ciascuno di questi account. I bucket tra più account non sono supportati.

  • (Facoltativo ma consigliato) Diversificati dal bucket che potresti utilizzare per la registrazione di log dei prompt.

  • Includi un prefisso, noto anche come sottocartella, in cui Amazon Q salverà il file CSV. Il file CSV non può essere salvato nella root del bucket.

  • Adotta una policy di bucket come quella che segue. Sostituisci bucketNameregion,accountId, e prefix con le tue informazioni.

    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QDeveloperLogsWrite",
            "Effect": "Allow",
            "Principal": {
                "Service": "q.amazonaws.com"
            },
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucketName/prefix/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:codewhisperer:us-east-1:111122223333:*"
                }
            }
        }
    ]
}

    Se configuri SSE-KMS sul bucket, aggiungi la seguente policy alla chiave KMS:

    {
    "Effect": "Allow",
    "Principal": {
        "Service": "q.amazonaws.com"
    },
    "Action": "kms:GenerateDataKey",
    "Resource": "*",
    "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "accountId" 
        },
        "ArnLike": {
           "aws:SourceArn": "arn:aws:codewhisperer:region:accountId:*"
        }
    }
}

    Per maggiori informazioni sulla protezione dei dati nel tuo bucket Amazon S3, consulta Protezione dei dati con la crittografia nella Guida per l’utente di Amazon Simple Storage Service.

Per abilitare i report sulle attività degli utenti

  1. Apri la console Amazon Q Developer.

    Per utilizzare la console Amazon Q Developer, è necessario disporre delle autorizzazioni definite in Consenti agli amministratori di utilizzare la console Amazon Q Developer.

  2. Seleziona Impostazioni.

  3. In Report sulle attività degli utenti di Q Developer, scegli Modifica.

  4. Attiva Raccogli metriche granulari per utente.

  5. In posizione S3, inserisci l’URI di Amazon S3 che utilizzerai per archiviare i report CSV. Ad esempio: s3://amzn-s3-demo-bucket/user-activity-reports/