Microsoft SQL Server（非推奨）

Microsoft SQL/MSQL モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

注: このモニターは、OpenTelemetry ネイティブコンポーネント Microsoft SQL server receiver レシーバーに置き換えられたため、非推奨となりました。詳細については、「Microsoft SQL Server レシーバー」を参照してください。

Splunk Distribution of OpenTelemetry Collectorは、Microsoft SQL Serverインスタンスからメトリクスを送信するために、Microsoft SQL Server モニタータイプでSmart Agentレシーバーを使用します。

メリット

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。

インストール

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

認証

このインテグレーションは、Windows 認証と SQL 認証をサポートしています。Windows 認証がデフォルトのオプションです。Windows で認証できない場合は、代わりに SQL 認証を使用します。

Windows 認証では、ローカルシステムアカウントを使用して Microsoft SQL Server にアクセスします。
SQL 認証では、インテグレーション用に設定したアカウントが使用されます。「Microsoft SQL 認証」を参照してください。

マイクロソフトSQL認証

インテグレーションを使用するには、Microsoft SQL Server ホストにログイン認証情報を作成する必要があります。このログイン情報を作成するには、以下の手順に従います。

管理者としてログインします。
SQLクライアントを起動します。

以下のコマンドを入力します：

USE master;
GO
CREATE LOGIN [<user_id>] WITH PASSWORD = '<YOUR PASSWORD HERE>';
GO
GRANT VIEW SERVER STATE TO [<user_id>];
GO
GRANT VIEW ANY DEFINITION TO [<user_id>];
GO

設定

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：Collector を理解して使用する」を参照してください。

例

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/sqlserver:
    type: telegraf/sqlserver
    ...  # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/sqlserver]

例：Microsoft SQL Server レシーバー

以下は、Microsoft SQL Server レシーバーの構成例です：

receivers:
  smartagent/sqlserver:
     type: telegraf/sqlserver
     host: <host_name>
     port: 1433
     userID: <user_id>
     password: <password>
     appName: sqlserver

コンフィギュレーション設定

次の表は、Microsoft SQL Server モニターの設定オプションを示しています：


オプション	必須	タイプ	説明
`host`	〇	`string`
`port`	〇	`integer`
`userID`	いいえ	`string`	SQL Server インスタンスへのアクセスに使用される UserID。
`password`	いいえ	`string`	SQL Serverインスタンスへのアクセスに使用するパスワード。
`appName`	いいえ	`string`	SQLServer に接続する際にモニターが使用するアプリ名。（デフォルト：`signalfxagent`）
`queryVersion`	いいえ	`integer`	クラスターにアクセスする際に使用するクエリのバージョン。ビジネスインサイトの Influxdata が提供する Microsoft SQL Server Telegraf Plugin のドキュメントを参照してください。（デフォルト：`2`）
`azureDB`	いいえ	`bool`	データベースがMicrosoft Azureデータベースであるかどうか。（デフォルト：`false`）
`excludedQueries`	いいえ	`list of strings`	除外するクエリ。可能な値は、`PerformanceCounters`、 `WaitStatsCategorized`、`DatabaseIO`、`DatabaseProperties`、`CPUHistory`、`DatabaseSize`、`DatabaseStats`、`MemoryClerk`、`VolumeSpace`、および `PerformanceMetrics` です。
`log`	いいえ	`unsigned integer`	データベースへのアクセス時に使用するログレベル（デフォルト： `1`）

メトリクス

このインテグレーションにより、一連のメトリクスが提供されます。一部のメトリクスは、データベースインスタンスのタイプに依存する可能性があることに注意してください。

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/telegraf/monitors/mssqlserver/metadata.yaml

備考

Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______

TCP/IPを非アクティブにする

一部の Windows ベースの SQL Server インスタンスでは、TCP/IP がデフォルトで非アクティブになっています。これは、Microsoft Azure サービスインスタンスで発生する可能性があります。Cannot read handshake packet: read tcp: wsarecv: An existing connection was forcibly closed by the remote host. のようなエラーメッセージが表示された場合は、インスタンスの TCP/IP を明示的にアクティブにする必要があります。

エージェントの設定が正しいことを確認します。
SQL Server インスタンスで、TCP/IP をアクティブにします。そのためには [Start > Administrative Tools > Computer Management] を選択します。
[Computer Management] サイドバーで [Services and Applications > SQL Server Configuration Manager > SQL Server Network Configuration] を選択します。
Protocols for <your_sql_server_name> を選択します。
プロトコルリストで [TCP/IP] プロトコルを選択し、[Enable] を選択します。