定期的に、ログをエクスポートしてから、Azure にアップロードできます。 ログのエクスポートとアップロードにより、データ コントローラーと Azure Arc 対応 SQL マネージド インスタンスも作成および更新されます。
開始する前に
ログをアップロードする前に、次を実行する必要があります。
この記事の例では、山かっこ < ... > を使用して、スクリプトを実行する前に置き換える必要がある値を識別します。 山かっこと山かっこ内の値を置き換えます。
ログ分析ワークスペースを作成する
Log Analytics ワークスペースを作成するには、こちらのコマンドを実行して Log Analytics ワークスペースを作成し、アクセス情報を環境変数内に設定します。
Note
既にワークスペースがある場合は、この手順をスキップしてください。
az monitor log-analytics workspace create --resource-group <resource group name> --workspace-name <some name you choose>
Example output:
{
"customerId": "00000000-0000-0000-0000-000000000000",
"eTag": null,
"id": "/subscriptions/<Subscription ID>/resourcegroups/user-arc-demo/providers/microsoft.operationalinsights/workspaces/user-logworkspace",
"___location": "eastus",
"name": "user-logworkspace",
"portalUrl": null,
"provisioningState": "Succeeded",
"resourceGroup": "user-arc-demo",
"retentionInDays": 30,
"sku": {
"lastSkuUpdate": "Thu, 30 Jul 2020 22:37:53 GMT",
"maxCapacityReservationLevel": 3000,
"name": "pergb2018"
},
"source": "Azure",
"tags": null,
"type": "Microsoft.OperationalInsights/workspaces"
}
環境変数に ID と共有キーを割り当てる
後で使用するために、Log Analytics ワークスペースの customerId を環境変数として保存します。
SET WORKSPACE_ID=<customerId>
このコマンドを実行すると、Log Analytics ワークスペースに接続するために必要なアクセス キーが返されます。
az monitor log-analytics workspace get-shared-keys --resource-group MyResourceGroup --workspace-name MyLogsWorkpace
Example output:
{
"primarySharedKey": "<primarySharedKey>==",
"secondarySharedKey": "<secondarySharedKey>=="
}
後で使用するため、プライマリ キーを環境変数に保存します。
SET WORKSPACE_SHARED_KEY=<primarySharedKey>
環境変数を確認する
必要に応じて、必要なすべての環境変数が設定されていることを調べて確認します。
echo %WORKSPACE_ID%
echo %WORKSPACE_SHARED_KEY%
環境変数を設定したら、ログをログ ワークスペースにアップロードできます。
az CLI を使用して直接モードでの Azure Log Analytics ワークスペースへのログの自動アップロードを構成する
In the direct connected mode, Logs upload can only be set up in automatic mode. メトリックのこの自動アップロードは、Azure Arc データ コントローラーのデプロイ中またはデプロイ後に設定できます。
Azure Log Analytics ワークスペースへのログの自動アップロードを有効にする
Azure Arc データ コントローラーのデプロイ中にログの自動アップロードが無効になっている場合は、次のコマンドを実行してログの自動アップロードを有効にします。
az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-logs true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-logs true
Azure Log Analytics ワークスペースへのログの自動アップロードを有効にする
Azure Arc データ コントローラーのデプロイ中にログの自動アップロードが有効になっている場合は、次のコマンドを実行してログの自動アップロードを無効にします。
az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-logs false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-logs false
Configure automatic upload of logs to Azure Log Analytics Workspace in direct mode using kubectl CLI
Azure Log Analytics ワークスペースへのログの自動アップロードを有効にする
kubectl を使用してログの自動アップロードを構成するには:
- 前のセクションで説明したように Log Analytics ワークスペースが作成されていることを確認します
- 次のように
WorkspaceIDおよびSharedAccessKeyを使用して Log Analytics ワークスペースの Kubernetes シークレットを作成します。
apiVersion: v1
data:
primaryKey: <base64 encoding of Azure Log Analytics workspace primary key>
workspaceId: <base64 encoding of Azure Log Analytics workspace Id>
kind: Secret
metadata:
name: log-workspace-secret
namespace: <your datacontroller namespace>
type: Opaque
シークレットを作成するには、以下を実行します。
kubectl apply -f <myLogAnalyticssecret.yaml> --namespace <mynamespace>既定のエディターで設定を yaml ファイルとして開くには、以下を実行します。
kubectl edit datacontroller <DC name> --name <namespace>autoUploadLogs プロパティを
"true"に更新し、ファイルを保存します
Azure Log Analytics ワークスペースへのログの自動アップロードを有効にする
ログの自動アップロードを無効にするには、以下を実行します。
kubectl edit datacontroller <DC name> --name <namespace>
- autoUploadLogs プロパティを
"false"に更新し、ファイルを保存します
Upload logs to Azure Monitor in indirect mode
Azure Arc によって有効になっている SQL Managed Instance のログをアップロードするには、次の CLI コマンドを実行します。
指定したファイルにすべてのログをエクスポートします。
Note
コマンド
az arcdata dc exportを使用して使用状況および課金情報、メトリック、ログをエクスポートするには、今のところ SSL 検証をバイパスする必要があります。 SSL 検証をバイパスするように求めるメッセージが表示されます。または、プロンプトを表示しないように環境変数AZDATA_VERIFY_SSL=noを設定できます。 現在、データ コントローラー エクスポート API に対して SSL 証明書を構成する方法はありません。az arcdata dc export --type logs --path logs.json --k8s-namespace arcAzure Monitor のログ分析ワークスペースにログをアップロードします。
az arcdata dc upload --path logs.json
Azure portal でログを表示する
ログがアップロードされたら、ログ クエリ エクスプローラーを使用して次のようにクエリを実行できるようになります。
- Azure portal を開いてから、上部の検索バーで名前を指定してご使用のワークスペースを検索し、それを選択します。
- 左側のパネルで [ログ] を選択します。
- [作業の開始] を選択します (または、Log Analytics を初めて使用する場合は、[作業の開始] ページのリンクを選択して詳細を確認します)。
- Log Analytics を初めて使用する場合は、チュートリアルに従って Log Analytics の詳細を確認します。
- テーブルの一覧の下部にある [カスタム ログ] を展開すると、'sql_instance_logs_CL' という名前のテーブルが表示されます。
- テーブル名の横にある目のアイコンを選択します。
- [クエリ エディターで表示] ボタンを選択します。
- これでクエリ エディター内にクエリが表示されるようになり、ログ内で最も新しい 10 個のイベントが表示されます
- ここからは、クエリ エディターやアラートの設定を使用して、ログのクエリを試してみることができます。
アップロードの自動化 (省略可能)
メトリックとログをスケジュールに基づいてアップロードする場合は、スクリプトを作成して、タイマーで数分ごとに実行できます。 次に、Linux シェル スクリプトを使用してアップロードを自動化する例を示します。
お好きなテキスト エディターまたはコード エディターで、ファイルに次のスクリプトを追加し、.sh (Linux/Mac)、.cmd、.bat、.ps1 (Windows) などのスクリプト実行可能ファイルとして保存します。
az arcdata dc export --type logs --path logs.json --force --k8s-namespace arc
az arcdata dc upload --path logs.json
スクリプト ファイルを実行可能にする
chmod +x myuploadscript.sh
20 分ごとにスクリプトを実行します。
watch -n 1200 ./myuploadscript.sh
Cron や Windows タスク スケジューラのようなジョブ スケジューラを使用することも、Ansible、Puppet、Chef のようなオーケストレーターを使用することもできます。
Related content
メトリックとログを Azure Monitor にアップロードする
使用状況データ、メトリック、およびログを Azure Monitor にアップロードする