Surveillance

Dans Feature Store Vertex AI, vous pouvez surveiller et définir des alertes sur les featurestores et les caractéristiques. Par exemple, une équipe chargée des opérations peut surveiller un featurestore pour suivre l'utilisation de son processeur. Les propriétaires de caractéristiques, tels que les data scientists, peuvent surveiller les valeurs des caractéristiques pour détecter les écarts au fil du temps.

Les méthodes de surveillance des featurestores et des caractéristiques sont décrites dans les sections suivantes:

Surveillance des featurestores

Feature Store Vertex AI signale les métriques de votre featurestore à Cloud Monitoring, telles que la charge du processeur, la capacité de stockage et la latence des requêtes. Vertex AI collecte et signale ces métriques pour vous. Vous n'avez pas besoin de configurer ni d'activer la surveillance du featurestore.

Pour configurer des seuils et des notifications, utilisez Cloud Monitoring. Par exemple, vous pouvez définir une alerte si la charge moyenne du processeur dépasse 70%, ce qui peut vous obliger à augmenter le nombre de nœuds de featurestores.

Vous pouvez également afficher les métriques du featurestore dans la console Vertex AI pour voir les tendances au fil du temps. Pour certains graphiques, la console affiche des valeurs cumulées ou calculées pour faciliter la consommation des informations. Vous pouvez toujours afficher les données brutes dans Cloud Monitoring.

Pour en savoir plus, consultez les métriques de surveillance de Feature Store Vertex AI sur la page Cloud Monitoring de Vertex AI.

Surveillance de la valeur des caractéristiques

La surveillance des valeurs des caractéristiques vous permet de suivre l'évolution de la distribution des valeurs d'une caractéristique dans le temps dans un featurestore. Feature Store Vertex AI prend des instantanés périodiques de vos valeurs de caractéristiques. Au fil du temps, à mesure que vous ingérez de plus en plus de données, vous remarquerez peut-être que la distribution des valeurs de caractéristiques change. Cette modification indique que tout modèle utilisant ces caractéristiques devra peut-être être réentraîné.

Imaginons, par exemple, que vous ayez une caractéristique qui collecte les prix des maisons récemment vendues, qui alimente un modèle permettant de prédire le prix d'une maison. Les prix des maisons récemment vendues peuvent diminuer considérablement au fil du temps. Feature Store Vertex AI peut vous avertir de cette modification afin que vous puissiez réentraîner votre modèle pour utiliser les informations les plus récentes.

Définir une configuration de surveillance

Pour commencer à surveiller une caractéristique, définissez une configuration de surveillance sur celle-ci. Vous pouvez également définir une configuration de surveillance sur un type d'entité, ce qui permet la surveillance de toutes les caractéristiques de ce type d'entité. Si une caractéristique et son type d'entité ont tous les deux une configuration de surveillance, la configuration de surveillance de la caractéristique est prioritaire.

Vous devez utiliser l'API pour définir une configuration de surveillance. vous ne pouvez pas utiliser la console. La configuration de la surveillance spécifie s'il faut activer la surveillance et l'intervalle entre les instantanés. Pour en savoir plus, reportez-vous au type FeaturestoreMonitoringConfig dans la documentation de référence de l'API.

Vous pouvez définir la configuration de la surveillance lorsque vous créez ou mettez à jour un type de caractéristique ou d'entité.

L'exemple suivant définit une configuration de surveillance sur une caractéristique existante. Dans la configuration de la surveillance, vous spécifiez l'intervalle d'instantanés.

UI Web

  1. Dans la section "Vertex AI" de Google Cloud Console, accédez à la page Caractéristiques.

    Accéder à la page "Caractéristiques"

  2. Sélectionnez une région dans la liste déroulante Région.
  3. Dans le tableau des caractéristiques, consultez la colonne Caractéristiques pour trouver la caractéristique à mettre à jour, puis cliquez sur son nom pour afficher la page des détails.
  4. Dans la barre d'action, cliquez sur Edit info (Modifier les informations).
  5. Sélectionnez Remplacer la configuration de surveillance du type d'entité. Cette configuration remplace toutes les configurations de surveillance existantes ou futures sur le type d'entité de la caractéristique.
  6. Dans le champ Intervalle de temps de surveillance, saisissez le nombre de jours entre les instantanés.
  7. Cliquez sur Mettre à jour.

API REST et ligne de commande

Pour mettre à jour une caractéristique, envoyez une requête PATCH à l'aide de la méthode featurestores.patch.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • LOCATION : région où se trouve le featurestore, par exemple us-central1.
  • PROJECT: ID de votre projet ou numéro de projet.
  • FEATURESTORE_ID : ID du featurestore.
  • ENTITY_TYPE_ID: ID du type d'entité.
  • FEATURE_ID: ID de la caractéristique à mettre à jour.
  • DURATION: intervalle entre les instantanés, en jours.

Méthode HTTP et URL :

PATCH https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID/features/FEATURE_ID

Corps JSON de la requête :

{
  "monitoringConfig": {
    "snapshotAnalysis": {
      "monitoringIntervalDays": "DURATION"
    }
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID/features/FEATURE_ID"

PowerShell

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID/features/FEATURE_ID" | Select-Object -Expand Content

Des résultats semblables aux lignes suivantes devraient s'afficher : Vous pouvez utiliser OPERATION_ID dans la réponse pour obtenir l'état de l'opération.

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID/features/FEATURE_ID",
  "description": "DESCRIPTION",
  "valueType": "FEATURE_VALUE_TYPE",
  "createTime": "2021-07-22T23:18:31.339972Z",
  "updateTime": "2021-07-29T22:24:40.221821Z",
  "etag": "AMEw9yPGDpwUwHx39gIDIg5mTQz65GMhnYHRzRslVPonm1g8xTnsTC5YUibmWo2MIuI=",
  "monitoringConfig": {
    "snapshotAnalysis": {
      "monitoringIntervalDays": DURATION_IN_DAYS
    }
  }
}

Langages supplémentaires

Vous pouvez installer et utiliser les bibliothèques clientes Vertex AI suivantes pour appeler l'API Vertex AI. Les bibliothèques clientes Cloud offrent une expérience de développement optimisée en utilisant les conventions et styles naturels de chaque langage compatible.

Afficher la répartition des valeurs des caractéristiques

Utilisez Cloud Console pour afficher la distribution des valeurs des caractéristiques au fil du temps.

UI Web

  1. Dans la section "Vertex AI" de Google Cloud Console, accédez à la page Caractéristiques.

    Accéder à la page "Caractéristiques"

  2. Sélectionnez une région dans la liste déroulante Région.
  3. Dans la table des caractéristiques, analysez la colonne Caractéristiques pour rechercher la caractéristique dont vous souhaitez afficher les détails.
  4. Cliquez sur le nom d'une caractéristique pour en afficher les détails. Vous pouvez afficher la configuration de la surveillance de la caractéristique sous Configuration de la surveillance par type d'entité ou Configuration de la surveillance des caractéristique , qui indique l'intervalle de surveillance et si la configuration est activée.
  5. Cliquez sur Métriques pour afficher les métriques de distribution des valeurs de caractéristiques.