Configurare le statistiche di Developer Connect

Questo documento descrive come configurare Developer Connect Insights per rendere disponibili le informazioni di Developer Connect Insights per le indagini di Gemini Cloud Assist e in Cloud Logging.

Scopri di più sugli insight di Developer Connect.

Prima di iniziare

  1. Accedi al tuo Account Google.

    Se non ne hai già uno, registrati per creare un nuovo account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Developer Connect API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Developer Connect API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  8. L'abilitazione di Developer Connect abilita anche l'API Secret Manager.

  9. Installa Google Cloud CLI.

    Se l'hai già installato, assicurati di avere l'ultima versione installata eseguendo gcloud components update.

  10. Crea l'agente di servizio Developer Connect:
    gcloud beta services identity create \
    --service=developerconnect.googleapis.com \
    --project=PROJECT_NUM

    Il ruolo roles/developerconnect.serviceAgent viene aggiunto automaticamente a questo service agent.

Ruoli obbligatori

Se la configurazione degli approfondimenti è limitata a un'applicazione App Hub gestita da un progetto di gestione (limite della cartella):

  • L'utente che configura gli approfondimenti deve disporre dei seguenti ruoli nel progetto di gestione:
    • Developer Connect Insights Admin (roles/developerconnect.insightsAdmin)
    • Visualizzatore App Hub (roles/apphub.viewer)
  • Il service agent Developer Connect ha bisogno dei seguenti ruoli:
    • Ruolo Developer Connect Service Agent (roles/developerconnect.serviceAgent) e ruolo Developer Connect Insights Agent (roles/developerconnect.insightsAgent) nel progetto di gestione.
    • Ruolo Agente Developer Connect Insights (roles/developerconnect.insightsAgent) dalla cartella contenente il progetto di gestione.

Se la configurazione degli approfondimenti è limitata a un'applicazione App Hub gestita da un progetto host:

  • L'utente che configura gli approfondimenti deve disporre dei seguenti ruoli nel progetto host:
    • Developer Connect Insights Admin (roles/developerconnect.insightsAdmin)
    • Visualizzatore App Hub (roles/apphub.viewer)
  • Il service agent Developer Connect ha bisogno dei seguenti ruoli:
    • Ruolo Developer Connect Service Agent (roles/developerconnect.serviceAgent) e ruolo Developer Connect Insights Agent (roles/developerconnect.insightsAgent) nel progetto host.
    • Ruolo Agente Developer Connect Insights (roles/developerconnect.insightsAgent) in tutti i progetti di servizio.
    • Se utilizzi risorse esistenti (ad esempio da Cloud Build o Artifact Registry) che non si trovano nella stessa cartella, concedi il ruolo Agente di Developer Connect Insights all'agente di servizio Developer Connect dal progetto host in questi progetti.

Se la configurazione delle statistiche è limitata a singoli progetti di destinazione:

  • L'utente che configura gli approfondimenti deve disporre dei seguenti ruoli nel progetto host:
    • Developer Connect Insights Admin (roles/developerconnect.insightsAdmin).
  • Il service agent Developer Connect ha bisogno dei seguenti ruoli:
    • Ruolo Developer Connect Service Agent (roles/developerconnect.serviceAgent) e ruolo Developer Connect Insights Agent (roles/developerconnect.insightsAgent) nel progetto host.
    • Ruolo Agente Developer Connect Insights (roles/developerconnect.insightsAgent) su tutti i progetti di destinazione.

Per visualizzare gli approfondimenti dalla riga di comando, gli utenti che visualizzano gli approfondimenti devono:

  • Developer Connect Insights Viewer (roles/developerconnect.insightsViewer) sul progetto host.
  • Ruolo Visualizzatore occorrenze Container Analysis (roles/containeranalysis.occurrences.viewer) nel progetto host.

Per l'utilizzo di singoli strumenti o per casi d'uso specifici, potrebbero essere necessari ruoli e autorizzazioni aggiuntivi Google Cloud o non Google. Se si verificano errori di autorizzazione, contatta l'amministratore per assicurarti di disporre dei ruoli e delle autorizzazioni corretti.

Oltre a questi ruoli e autorizzazioni, quando configuri una nuova configurazione degli approfondimenti utilizzando il flusso di lavoro interattivo, devi disporre dell'autorizzazione per accedere a tutte le risorse che specifichi.

Prerequisiti aggiuntivi

  • Se vuoi che gli approfondimenti di Developer Connect siano limitati a un'applicazione App Hub, devi avere o creare l'applicazione.

    Developer Connect Insights supporta tutti i modelli di configurazione di App Hub per le applicazioni. Ti consigliamo di utilizzare una