Créer un espace de travail Log Analytics

Article
10/15/2024

Un espace de travail log Analytique est un magasin de données dans lequel vous pouvez collecter n’importe quel type de données de journal à partir de toutes vos ressources et applications Azure et non-Azure. Nous vous recommandons d’envoyer toutes les données de journal à un espace de travail Log Analytics, sauf si vous avez des besoins métier spécifiques qui vous obligent à créer plusieurs espaces de travail, comme décrit dans Concevoir une architecture d’espace de travail Log Analytics.

Cet article explique comment créer un espace de travail Log Analytics.

Prérequis

Si vous souhaitez créer une espace de travail Log Analytics, vous devez avoir un compte Azure avec un abonnement actif. Vous pouvez créer un compte gratuitement.

Autorisations requises

Vous devez avoir des autorisations Microsoft.OperationalInsights/workspaces/write sur le groupe de ressources dans lequel vous souhaitez créer l’espace de travail Log Analytics, telles que fournies par le rôle intégré Contributeur Log Analytics, par exemple.

Créer un espace de travail

Utilisez le menu Espaces de travail Log Analytics pour créer un espace de travail.

Dans le portail Azure, entrez Log Analytics dans la zone de recherche. Au fur et à mesure de la saisie, la liste est filtrée. Sélectionnez Espaces de travail Log Analytics.
Sélectionnez Ajouter.
Choisissez un abonnement dans la liste déroulante.
Utilisez un groupe de ressources existant ou créez-en un.
Attribuez un nom au nouvel Espace de travail Log Analytics comme DefaultLAWorkspace. Ce nom doit être unique par groupe de ressources.
Sélectionnez une Région disponible. Pour plus d’informations, découvrez dans quelles régions Log Analytics est disponible. Recherchez Azure Monitor dans la zone Rechercher un produit.
Sélectionnez Vérifier + créer pour passer en revue les paramètres. Sélectionnez ensuite Créer pour créer l’espace de travail. Un niveau tarifaire par défaut de paiement à l’utilisation est appliqué. Vous n’êtes pas facturé tant que vous n’avez pas commencé à collecter suffisamment de données. Pour plus d’informations sur les autres niveaux tarifaires, consultez les Détails de prix de Log Analytics.

L’exemple de script suivant crée un espace de travail sans configuration de source de données.

$ResourceGroup = <"my-resource-group">
$WorkspaceName = <"log-analytics-workspace-name">
$Location = <"westeurope">

# Create the resource group if needed
try {
    Get-AzResourceGroup -Name $ResourceGroup -ErrorAction Stop
} catch {
    New-AzResourceGroup -Name $ResourceGroup -Location $Location
}

# Create the workspace
New-AzOperationalInsightsWorkspace -Location $Location -Name $WorkspaceName -ResourceGroupName $ResourceGroup

Notes

Log Analytics s’appelait Operational Insights. Les cmdlet PowerShell utilisent Operational Insights dans les commandes Log Analytics.

Après avoir créé un espace de travail, configurez un espace de travail Log Analytics dans Azure Monitor en utilisant PowerShell.

Exécutez la commande az group create pour créer un groupe de ressources ou utiliser un groupe de ressources existant. Pour créer un espace de travail, utilisez la commande az monitor log-analytics workspace create.

    az group create --name <myGroup> --location <myLocation>
    az monitor log-analytics workspace create --resource-group <myGroup> \
       --workspace-name <myWorkspace>

Pour plus d’informations sur les journaux Azure Monitor dans Azure CLI, consultez Gestion des journaux Azure Monitor dans Azure CLI.

L’exemple suivant utilise les espaces de travail Microsoft.OperationalInsights pour créer un espace de travail Log Analytics dans Azure Monitor. Pour plus d’informations sur Bicep, consultez Vue d’ensemble de Bicep.

Remarque

Pour obtenir une liste des exemples disponibles et des conseils sur leur déploiement dans votre abonnement Azure, consultez la page Exemples Azure Resource Manager pour Azure Monitor.

Fichier Bicep

@description('Name of the workspace.')
param workspaceName string

@description('Pricing tier: PerGB2018 or legacy tiers (Free, Standalone, PerNode, Standard or Premium) which are not available to all customers.')
@allowed([
  'pergb2018'
  'Free'
  'Standalone'
  'PerNode'
  'Standard'
  'Premium'
])
param sku string = 'pergb2018'

@description('Specifies the location for the workspace.')
param location string

@description('Number of days to retain data.')
param retentionInDays int = 120

@description('true to use resource or workspace permissions. false to require workspace permissions.')
param resourcePermissions bool

@description('Number of days to retain data in Heartbeat table.')
param heartbeatTableRetention int

resource workspace 'Microsoft.OperationalInsights/workspaces@2023-09-01' = {
  name: workspaceName
  location: location
  properties: {
    sku: {
      name: sku
    }
    retentionInDays: retentionInDays
    features: {
      enableLogAccessUsingOnlyResourcePermissions: resourcePermissions
    }
  }
}

resource workspaceName_Heartbeat 'Microsoft.OperationalInsights/workspaces/tables@2022-10-01' = {
  parent: workspace
  name: 'Heartbeat'
  properties: {
    retentionInDays: heartbeatTableRetention
  }
}

Remarque

Si vous indiquez un niveau tarifaire Gratuit, supprimez l’élément retentionInDays.

Fichier de paramètres

using './main.bicep'

param workspaceName = 'MyWorkspace'
param sku = 'pergb2018'
param location = 'eastus'
param retentionInDays = 120
param resourcePermissions = true
param heartbeatTableRetention = 30

L’exemple suivant utilise le modèle d’espaces de travail Microsoft.OperationalInsights pour créer un espace de travail Log Analytics dans Azure Monitor. Pour plus d’informations sur les modèles Azure Resource Manager, consultez Modèles Azure Resource Manager.

Notes

Pour obtenir une liste des exemples disponibles et des conseils sur leur déploiement dans votre abonnement Azure, consultez Exemples Azure Resource Manager pour Azure Monitor.

Fichier de modèle

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the workspace."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "pergb2018",
      "allowedValues": [
        "pergb2018",
        "Free",
        "Standalone",
        "PerNode",
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "Pricing tier: PerGB2018 or legacy tiers (Free, Standalone, PerNode, Standard or Premium) which are not available to all customers."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Specifies the location for the workspace."
      }
    },
    "retentionInDays": {
      "type": "int",
      "defaultValue": 120,
      "metadata": {
        "description": "Number of days to retain data."
      }
    },
    "resourcePermissions": {
      "type": "bool",
      "metadata": {
        "description": "true to use resource or workspace permissions. false to require workspace permissions."
      }
    },
    "heartbeatTableRetention": {
      "type": "int",
      "metadata": {
        "description": "Number of days to retain data in Heartbeat table."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "2023-09-01",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('location')]",
      "properties": {
        "sku": {
          "name": "[parameters('sku')]"
        },
        "retentionInDays": "[parameters('retentionInDays')]",
        "features": {
          "enableLogAccessUsingOnlyResourcePermissions": "[parameters('resourcePermissions')]"
        }
      }
    },
    {
      "type": "Microsoft.OperationalInsights/workspaces/tables",
      "apiVersion": "2022-10-01",
      "name": "[format('{0}/{1}', parameters('workspaceName'), 'Heartbeat')]",
      "properties": {
        "retentionInDays": "[parameters('heartbeatTableRetention')]"
      },
      "dependsOn": [
        "workspace"
      ]
    }
  ]
}

Notes

Si vous indiquez un niveau tarifaire Gratuit, supprimez l’élément retentionInDays.

Fichier de paramètres

{
  "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "value": "MyWorkspace"
    },
    "sku": {
      "value": "pergb2018"
    },
    "location": {
      "value": "eastus"
    },
    "resourcePermissions": {
      "value": true
    },
    "heartbeatTableRetention": {
      "value": 30
    }
  }
}

Dépannage

Lorsque vous créez un espace de travail qui a été supprimé au cours des 14 derniers jours et qui se trouve dans l’état de suppression réversible, l’opération peut avoir un résultat différent en fonction de la configuration de votre espace de travail :

Si vous fournissez les mêmes nom d’espace de travail, groupe de ressources, abonnement et région que dans l’espace de travail supprimé, votre espace de travail est récupéré avec ses données, sa configuration et ses agents connectés.
Les noms d’espace de travail doivent être uniques dans un groupe de ressources. Si vous utilisez un nom d’espace de travail qui existe déjà ou est supprimé de manière réversible, une erreur est retournée. Pour supprimer définitivement votre espace de travail supprimé de manière réversible et créer un espace de travail portant le même nom, suivez ces étapes :
1. Récupérez votre espace de travail.
2. Supprimez définitivement votre espace de travail.
3. Créez un espace de travail en utilisant le même nom d’espace de travail.

Étapes suivantes

Disposant à présent d’un espace de travail, vous pouvez configurer la collecte des données de télémétrie de surveillance, exécuter des recherches dans les journaux pour analyser ces données et ajouter une solution de gestion pour fournir d’autres données et insights analytiques. Pour en savoir plus :

Pour créer des règles d’alerte visant à superviser l’intégrité de votre espace de travail, consultez Superviser l’intégrité d’un espace de travail Log Analytics dans Azure Monitor.
Pour activer la collecte de données à partir de ressources Azure avec Diagnostics Azure ou le Stockage Azure, consultez Collecter les journaux et les métriques des services Azure à utiliser dans Log Analytics.

Partager via

Créer un espace de travail Log Analytics

Prérequis

Autorisations requises

Créer un espace de travail

Fichier Bicep

Fichier de paramètres

Fichier de modèle

Fichier de paramètres

Dépannage

Étapes suivantes

Commentaires

Ressources supplémentaires