Supported OS
概要
このチェックは、Datadog Agent を通じて Cyral MySQL サイドカーを監視します。
セットアップ
Cyral チェックは Datadog Agent パッケージに含まれていないため、お客様自身でインストールする必要があります。
インストール
Agent v7.21 / v6.21 以降の場合は、下記の手順に従い Cyral チェックをホストにインストールします。Docker Agent または 上記バージョン以前の Agent でインストールする場合は、コミュニティインテグレーションの使用をご参照ください。
以下のコマンドを実行して、Agent インテグレーションをインストールします。
datadog-agent integration install -t datadog-cyral==<INTEGRATION_VERSION>
コアのインテグレーションと同様にインテグレーションを構成します。
構成
cyral のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/
フォルダーの cyral.d/conf.yaml
ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル cyral.d/conf.yaml を参照してください。
init_config:
instances:
# url of the metrics endpoint of prometheus
- prometheus_url: http://localhost:9018/metrics
Agent を再起動します。
検証
Agent の status サブコマンドを実行し、Checks セクションで cyral
を探します。
収集データ
メトリクス
cyral.analysis_time (count) | Time spent in just doing analysis Shown as millisecond |
cyral.authentication_failure_count (count) | The number of authentication failures |
cyral.catalog_query_count (count) | |
cyral.closed_client_conns_count (count) | |
cyral.closed_listeners_count (count) | |
cyral.high_latency_query_count (count) | Number of queries exceeding (configurable) threshold |
cyral.open_client_conns_count (count) | |
cyral.open_listeners_count (count) | |
cyral.policy_eval_time (count) | |
cyral.policy_eval_time_counter (count) | |
cyral.policy_violation_count (count) | The number of queries with policy violations |
cyral.portscan_count (count) | The number of detected portscan attempts |
cyral.queries_with_errors (count) | |
cyral.query_duration_count (count) | Number of increments to query_duration |
cyral.query_duration_sum (count) | The total duration of queries in milliseconds |
cyral.repo_dial_errors_count (count) | |
cyral.row_count (count) | The number of rows per query |
cyral.sql_parse_time (count) | Time spent doing parsing in milliseconds |
cyral.sql_parse_time_counter (count) | Number of increments to sqlparsetime |
cyral.storage_watch_events_count (count) | |
cyral.wire_dial_errors_count (count) | |
cyral.wire_parse_duration (count) | |
cyral.wire_parse_duration_increments (count) | |
サービスチェック
Cyral には、サービスのチェック機能は含まれません。
イベント
Cyral には、イベントは含まれません。
トラブルシューティング
Agent が接続できない
cyral
-------
- instance #0 [ERROR]: "('Connection aborted.', error(111, 'Connection refused'))"
- Collected 0 metrics, 0 events & 0 service check
cyral.yaml
内の url
が正しいかどうかを確認してください。
ご不明な点は、Datadog のサポートチームまでお問い合わせください。