Cyral

Supported OS Linux

Integrationv0.0.1

概要

このチェックは、Datadog Agent を通じて Cyral MySQL サイドカーを監視します。

セットアップ

Cyral チェックは Datadog Agent パッケージに含まれていないため、お客様自身でインストールする必要があります。

インストール

Agent v7.21 / v6.21 以降の場合は、下記の手順に従い Cyral チェックをホストにインストールします。Docker Agent または 上記バージョン以前の Agent でインストールする場合は、コミュニティインテグレーションの使用をご参照ください。

  1. 以下のコマンドを実行して、Agent インテグレーションをインストールします。

    datadog-agent integration install -t datadog-cyral==<INTEGRATION_VERSION>
    
  2. コアのインテグレーションと同様にインテグレーションを構成します。

コンフィギュレーション

  1. 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
    
  2. 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 のサポートチームまでお問い合わせください。