Viste nelle soluzioni di gestione di Operations Management Suite (OMS) (anteprima)Views in Operations Management Suite (OMS) management solutions (Preview)

Nota

Questa è una documentazione preliminare per la creazione di soluzioni di gestione in OMS attualmente disponibili in versione di anteprima.This is preliminary documentation for creating management solutions in OMS which are currently in preview. Qualsiasi schema descritto di seguito è soggetto a modifiche.Any schema described below is subject to change.

Le soluzioni di gestione in Operations Management Suite (OMS) includono in genere una o più viste per visualizzare i dati.Management solutions in Operations Management Suite (OMS) will typically include one or more views to visualize data. Questo articolo descrive come esportare una vista creata da Progettazione viste e includerla in una soluzione di gestione.This article describes how to export a view created by the View Designer and include it in a management solution.

Nota

Gli esempi in questo articolo usano parametri e variabili che sono richiesti o comuni nelle soluzioni di gestione e che sono descritti in Creazione di soluzioni di gestione in Operations Management Suite (OMS)The samples in this article use parameters and variables that are either required or common to management solutions and described in Creating management solutions in Operations Management Suite (OMS)

PrerequisitiPrerequisites

Questo articolo presuppone che si abbia già familiarità con le modalità di creazione di una soluzione di gestione e la struttura di un file di soluzione.This article assumes that you're already familiar with how to create a management solution and the structure of a solution file.

PanoramicaOverview

Per includere una vista in una soluzione di gestione, si crea una risorsa per la vista nel file di soluzione.To include a view in a management solution, you create a resource for it in the solution file. In genere, tuttavia, il codice JSON che descrive la configurazione dettagliata della vista è complesso e l'autore tipico di una soluzione probabilmente non è in grado di crearlo manualmente.The JSON that describes the view's detailed configuration is typically complex though and not something that a typical solution author would be able to create manually. Il metodo più comune consiste nel creare la vista usando Progettazione viste, esportarla e quindi aggiungere la sua configurazione dettagliata alla soluzione.The most common method is to create the view using the View Designer, export it, and then add its detailed configuration to the solution.

I passaggi di base per aggiungere una vista a una soluzione sono i seguenti.The basic steps to add a view to a solution are as follows. Ogni passaggio viene descritto in modo più dettagliato nelle sezioni successive.Each step is described in further detail in the sections below.

  1. Esportare la vista in un file.Export the view to a file.
  2. Creare la risorsa vista nella soluzione.Create the view resource in the solution.
  3. Aggiungere i dettagli della vista.Add the view details.

Esportare la vista in un fileExport the view to a file

Seguire le istruzioni in Progettazione viste di Log Analytics per esportare una vista in un file.Follow the instructions at Log Analytics View Designer to export a view to a file. Il file esportato sarà nel formato JSON con gli stessi elementi del file di soluzione.The exported file will be in JSON format with the same elements as the solution file.

L'elemento resources del file della vista avrà una risorsa di tipo Microsoft.OperationalInsights/workspaces che rappresenta l'area di lavoro OMS.The resources element of the view file will have a resource with a type of Microsoft.OperationalInsights/workspaces that represents the OMS workspace. Questo elemento avrà un sottoelemento di tipo views che rappresenta la vista e contiene la configurazione dettagliata.This element will have a subelement with a type of views that represents the view and contains its detailed configuration. Sarà necessario copiare i dettagli di questo elemento e incollarli nella soluzione.You will copy the details of this element and then copy it into your solution.

Creare la risorsa vista nella soluzioneCreate the view resource in the solution

Aggiungere la risorsa vista seguente nell'elemento resources del file di soluzione.Add the following view resource to the resources element of your solution file. Vengono usate le variabili descritte di seguito, che è necessario aggiungere.This uses variables that are described below that you must also add. Si noti che le proprietà Dashboard e OverviewTile sono segnaposto che verranno sovrascritti con le proprietà corrispondenti del file della vista esportato.Note that the Dashboard and OverviewTile properties are placeholders that you will overwrite with the corresponding properties from the exported view file.

{
    "apiVersion": "[variables('LogAnalyticsApiVersion')]",
    "name": "[concat(parameters('workspaceName'), '/', variables('ViewName'))]",
    "type": "Microsoft.OperationalInsights/workspaces/views",
    "location": "[parameters('workspaceregionId')]",
    "id": "[Concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/', resourceGroup().name, '/providers/Microsoft.OperationalInsights/workspaces/', parameters('workspaceName'),'/views/', variables('ViewName'))]",
    "dependson": [
        ],
    "properties": {
        "Id": "[variables('ViewName')]",
        "Name": "[variables('ViewName')]",
        "DisplayName": "[variables('ViewName')]",
        "Description": "",
        "Author": "[variables('ViewAuthor')]",
        "Source": "Local",
        "Dashboard": ,
        "OverviewTile":
    }
}

Aggiungere le variabili seguenti all'elemento variables del file di soluzione e sostituire i valori con quelli della soluzione.Add the following variables to the variables element of the solution file and replace the values to those for your solution.

"LogAnalyticsApiVersion": "2015-11-01-preview",
"ViewAuthor": "Your name."
"ViewDescription": "Optional description of the view."
"ViewName": "Provide a name for the view here."

Si noti che è possibile copiare l'intera risorsa vista dal file della vista esportato, ma è necessario apportare le modifiche seguenti per consentirne il funzionamento nella soluzione.Note that you could copy the entire view resource from your exported view file, but you would need to make the following changes for it to work in your solution.

  • Il parametro type della risorsa vista deve essere modificato da views a Microsoft.OperationalInsights/workspaces.The type for the view resource needs to be changed from views to Microsoft.OperationalInsights/workspaces.
  • La proprietà name della risorsa vista deve essere modificata per includere il nome dell'area di lavoro.The name property for the view resource needs to be changed to include the workspace name.
  • La dipendenza dall'area di lavoro deve essere rimossa perché la risorsa area di lavoro non è definita nella soluzione.The dependency on the workspace needs to be removed since the workspace resource isn't defined in the solution.
  • La proprietà DisplayName deve essere aggiunta alla vista.DisplayName property needs to be added to the view. I valori di Id, Name e DisplayName devono corrispondere.The Id, Name, and DisplayName must all match.
  • I nomi dei parametri devono essere modificati in modo da corrispondere al set di parametri richiesto.Parameter names must be changed to match the required set of parameters.
  • Le variabili devono essere definite nella soluzione e usate nelle proprietà appropriate.Variables should be defined in the solution and used in the appropriate properties.

Aggiungere i dettagli della vistaAdd the view details

La risorsa vista nel file della vista esportato conterrà due elementi nell'elemento properties denominati Dashboard e OverviewTile che contengono la configurazione dettagliata della vista.The view resource in the exported view file will contain two elements in the properties element named Dashboard and OverviewTile which contain the detailed configuration of the view. Copiare questi due elementi e il relativo contenuto nell'elemento properties della risorsa vista nel file di soluzione.Copy these two elements and their contents into the properties element of the view resource in your solution file.

EsempioExample

L'esempio seguente mostra un file di soluzione semplice con una vista.For example, the following sample shows a simple solution file with a view. Al posto del contenuto di Dashboard e OverviewTile sono visualizzati i puntini di sospensione (...) per motivi di spazio.Ellipses (...) are shown for the Dashboard and OverviewTile contents for space reasons.

{
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "workspaceName": {
            "type": "string"
        },
        "accountName": {
            "type": "string"
        },
        "workspaceRegionId": {
            "type": "string"
        },
        "regionId": {
            "type": "string"
        },
        "pricingTier": {
            "type": "string"
        }
    },
    "variables": {
        "SolutionVersion": "1.1",
        "SolutionPublisher": "Contoso",
        "SolutionName": "Contoso Solution",
        "LogAnalyticsApiVersion": "2015-11-01-preview",
        "ViewAuthor":  "user@contoso.com",
        "ViewDescription":  "This is a sample view.",
        "ViewName":  "Contoso View"
    },
    "resources": [
        {
            "name": "[concat(variables('SolutionName'), '(' ,parameters('workspacename'), ')')]",
            "location": "[parameters('workspaceRegionId')]",
            "tags": { },
            "type": "Microsoft.OperationsManagement/solutions",
            "apiVersion": "[variables('LogAnalyticsApiVersion')]",
            "dependsOn": [
                "[concat('Microsoft.OperationalInsights/workspaces/', parameters('workspacename'), '/views/', variables('ViewName'))]"
            ],
            "properties": {
                "workspaceResourceId": "[concat(resourceGroup().id, '/providers/Microsoft.OperationalInsights/workspaces/', parameters('workspacename'))]",
                "referencedResources": [
                ],
                "containedResources": [
                    "[concat('Microsoft.OperationalInsights/workspaces/', parameters('workspaceName'), '/views/', variables('ViewName'))]"
                ]
            },
            "plan": {
                "name": "[concat(variables('SolutionName'), '(' ,parameters('workspaceName'), ')')]",
                "Version": "[variables('SolutionVersion')]",
                "product": "ContosoSolution",
                "publisher": "[variables('SolutionPublisher')]",
                "promotionCode": ""
            }
        },
        {
            "apiVersion": "[variables('LogAnalyticsApiVersion')]",
            "name": "[concat(parameters('workspaceName'), '/', variables('ViewName'))]",
            "type": "Microsoft.OperationalInsights/workspaces/views",
            "location": "[parameters('workspaceregionId')]",
            "id": "[Concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/', resourceGroup().name, '/providers/Microsoft.OperationalInsights/workspaces/', parameters('workspaceName'),'/views/', variables('ViewName'))]",
            "dependson": [
            ],
            "properties": {
                "Id": "[variables('ViewName')]",
                "Name": "[variables('ViewName')]",
                "DisplayName": "[variables('ViewName')]",
                "Description": "[variables('ViewDescription')]",
                "Author": "[variables('ViewAuthor')]",
                "Source": "Local",
                "Dashboard": ...,
                "OverviewTile": ...
            }
        }
      ]
}

Passaggi successiviNext steps