Créer un espace de travail Log Analytics

Un espace de travail Log Analytics est un magasin de données permettant de collecter n’importe quel type de données de journal à partir de toutes vos ressources et applications Azure et non Azure. Envoyez toutes les données de journal à un espace de travail Log Analytics, sauf si des besoins métier spécifiques nécessitent plusieurs espaces de travail, comme décrit dans Design a Log Analytics architecture d’espace de travail.

Prérequis

Si vous souhaitez créer une espace de travail Log Analytics, vous devez avoir un compte Azure avec un abonnement actif. Créez 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

Portail

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

1. Dans le portail Azure, entrez Log Analytics dans la zone de recherche. Lorsque vous commencez à saisir du texte, la liste se filtre en fonction de votre saisie. Sélectionnez Espaces de travail Log Analytics.

   

2. Cliquez sur Créer.

3. Choisissez un abonnement dans la liste déroulante.

4. Utilisez un groupe de ressources existant ou créez-en un.

5. Attribuez un nom au nouvel Espace de travail Log Analytics comme DefaultLAWorkspace. Ce nom doit être unique par groupe de ressources.

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

   

7. 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 de paiement à l’utilisation par défaut est appliqué et aucun frais n’est facturé tant que la collecte de données n’a pas commencé. Pour plus d’informations sur les niveaux tarifaires, consultez Log Analytics détails de tarification.

PowerShell

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

Remarque

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 à l’aide de PowerShell.

Azure CLI

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.

Biceps

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 spécifiez 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

modèle Azure Resource Manager

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.

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 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"
      ]
    }
  ]
}

Remarque

Si vous spécifiez 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 que vous avez supprimé au cours des 14 derniers jours et qu’il est à l’état de suppression réversible, l’opération peut avoir des résultats différents en fonction de la configuration de votre espace de travail :

1. Si vous créez un espace de travail et les paramètres que vous fournissez sont le même nom d’espace de travail, le groupe de ressources, l’abonnement et la région qu’un espace de travail supprimé, vous récupérez votre espace de travail supprimé, y compris ses données, sa configuration et ses agents connectés.

2. 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, vous obtenez une erreur. Pour supprimer définitivement le nom supprimé temporairement et créer un nouvel 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

Maintenant qu’un espace de travail est disponible, configurez la collecte des données de télémétrie et exécutez des recherches dans les journaux pour analyser ces données. Pour en savoir plus :

• Consultez Surveiller l’intégrité de l’espace de travail Log Analytics dans Azure Monitor pour créer des règles d’alerte qui surveillent l’intégrité de votre espace de travail.
• Consultez Collecter les journaux des ressources Azure pour activer la collecte de données des ressources Azure à l’aide des paramètres de diagnostic.