Cyral

Supported OS Linux

インテグレーションバージョン0.0.1

概要

このチェックは、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 のサポートチームまでお問い合わせください。