Cassandra接続プロパティ

Cassandra接続プロパティは、クラスター固有の構成ファイルcluster_name.confで構成します。

cluster_name.conf

cluster_name.confファイルの場所は、インストールのタイプによって異なります。
  • パッケージ・インストール:/etc/opscenter/clusters/cluster_name.conf
  • tarボール・インストール:install_location/conf/clusters/cluster_name.conf

これらのプロパティは、クラスター固有の構成ファイルcluster_name.conf内で定義された、DSEによって使用されるKerberosサービスのユーザー名に一致する必要があります。cluster_nameは、実際のクラスター名に置き換えます。

注: このファイルのプロパティを変更したら、変更内容を適用するためにOpsCenterを再起動します。
[jmx] port
クラスターのJMX(Java Management Extension)ポート。Cassandraバージョン0.8以降では、JMXポートは7199です。
[jmx] username
認証が有効になっている場合は、JMX(Java Management Extensions)ユーザー名。
[jmx] password
認証が有効になっている場合は、JMX(Java Management Extensions)パスワード。
[jmx] operations_pool_size
JMX(Java Management Extensions)操作のプール・サイズ。デフォルトは4です。
[cassandra] seed_hosts
Cassandraシード・ノードは、リング・トポロジーを特定し、クラスター内のノードに関するゴシップ情報を取得するために使用されます。このシード・ノードのコンマ区切りリストは、cassandra.yaml構成ファイルのシード・プロパティでDataStax Enterpriseクラスター用に構成したリストと同じでなければなりません。デフォルト値はlocalhostです。
[cassandra] api_port
クラスター用に構成されたThriftリモート・プロシージャー・コール・ポート。cassandra.yaml構成ファイルのrpc_portプロパティと同じです。デフォルトは9160です。
[cassandra] cql_port
クラスター用に構成されたCQLポート。デフォルト・ポートは9042です。
[cassandra] conf_location
cassandra.yaml構成ファイルの場所。install_locationを指定し、conf_locationを指定していない場合、conf_locationinstall_location/conf/cassandra.yamlであると見なされます。conf_locationを指定する場合は、すべてのノード上のCassandra構成ファイルの絶対パスを指定する必要があります。これらの設定はクラスター全体に適用されるため、すべてのノードに適切な場所を指定する必要があります。
[cassandra] install_location
Cassandraがインストールされているディレクトリー。install_locationを指定しない場合は、パッケージ固有のインストール場所が参照されます。DataStax Enterpriseのtarボール・インストールの場合、install_locationdse_install_location/resources/cassandraです。
[cassandra] log_location
ノード上のDSEログが存在するディレクトリー。デフォルトの場所は/var/log/cassandraです。この値によって、エージェントごとにcassandra_log_locationプロパティが自動的に追加されます。
[cassandra] local_dc_pref
この値を指定すると、OpsCenterでは指定したデータ・センターへの接続が優先的に使用されます。
[cassandra] used_hosts_per_remote_dc
local_dc_prefを使用する場合に、フォールバックとして使用されるリモートDC接続数を指定します。デフォルト値は1です。
[cassandra] connect_timeout
OpsCenterからCassandraへのThrift接続のタイムアウトを秒単位で設定します。デフォルト値は6.0です。
[cassandra] host_read_timeout_ms
データのクエリなど、CQL読み取り操作時にホストが応答しないと見なされるまでのタイムアウト値(ミリ秒)。このタイムアウト値は、Cassandra側(read_request_timeout_in_ms in cassandra.yaml)で使用されるタイムアウト設定より高い値を設定する必要があります。デフォルト:DataStax Java Driverのデフォルト値。
[cassandra] bind_interface
Thrift接続で使用するインターフェイス。
[cassandra] connection_pool_size
接続プール用に作成するThrift接続の数。デフォルト値は5です。
[cassandra] username
認証が有効になっている場合に、Cassandraへの接続に使用するユーザー名。
[cassandra] password
認証が有効になっている場合に、Cassandraへの接続に使用するパスワード。
[cassandra] send_rpc
Cassandra RPC IPをDataStaxエージェントに送信するかどうかを指定します。デフォルト値はTrueです。
[cassandra] ssl_keystore
Cassandraに直接接続するために使用するOpsCenterのSSLキーストアの場所。
[cassandra] ssl_keystore_password
Cassandraに直接接続するために使用するOpsCenterのSSLキーストアのパスワード。
[cassandra] ssl_truststore
Cassandraに直接接続するために使用するOpsCenterのSSLトラストストアの場所。
[cassandra] ssl_truststore_password
Cassandraに直接接続するために使用するOpsCenterのSSLトラストストアのパスワード。
[cassandra] snapshot_threshold
OpsCenterが要求を受信してすぐにバックアップを実行する状態から、1分単位で切り上げた時刻にsnapshot_waitに設定した時間を加えた時間が経過した後でバックアップを実行するようにスケジュールする状態に切り替わる、クラスター内のノード数の上限。デフォルト値は10です。クラスター内のノード数が10以下の場合、OpsCenterはすべてのノードに、要求を受信したらすぐにスナップショットを作成するように指示します。ノード数が10を超えると、OpsCenterはすべてのノードに、1分単位で切り上げた現在の時刻にsnapshot_wait秒を加えた時刻にスナップショットを作成するように指示します。
[cassandra] rolling_restart_retry_delay
ノードの再起動後にCassandraへの接続をリトライする間隔(秒)。デフォルト:5。
[cassandra] rolling_restart_retry_attempts
Cassandraノードの再起動後に接続をリトライする最大回数。デフォルト:25。
[cassandra] rolling_restart_error_threshold
再起動中にエラー数がこの数に達すると、ローリング再起動がキャンセルされます。これにより、ローリング再起動中に重大な問題が発生した場合に、クラスターで多くのノードがダウンするのを防ぐことができます。デフォルト:1
[cassandra] schema_refresh_interval
スキーマ変更コマンドの発行後にスキーマの更新を待機する時間(ミリ秒)。このオプションはopscenterdに適用されないさまざまなスキーマ作成ツールとともに使用されるため、間隔はデフォルト値0のままにしておく必要があります。
[cassandra] restart_delay
ローリング再起動中に、OpsCenterがCassandraの停止コマンドを送信してから再起動コマンドを送信するまでの待機時間(秒)。デフォルトは30秒です。
[storage_cassandra] seed_hosts
OpsCenterストレージに別のクラスターを使用する場合に構成します。Cassandraシード・ノードは、リング・トポロジーを特定し、クラスター内のノードに関するゴシップ情報を取得するために使用されます。このシード・ノードのコンマ区切りリストは、cassandra.yaml構成ファイルのシード・プロパティでDataStax Enterpriseクラスター用に構成したリストと同じでなければなりません。
[storage_cassandra] api_port
OpsCenterストレージに別のクラスターを使用する場合に構成します。クラスター用に構成されたThriftリモート・プロシージャー・コール・ポート。cassandra.yaml構成ファイルのrpc_portプロパティと同じです。デフォルトは9160です。
[storage_cassandra] cql_port
OpsCenterストレージに別のクラスターを使用する場合に構成します。クラスター用に構成されたCQLポート。デフォルト・ポートは9042です。
[storage_cassandra] local_dc_pref
クラスター情報を確実に特定するために、OpsCenterは2つ以上のノードに接続する必要があります。seed_hostsに単一値を指定した場合は、この要件を満たすためにOpsCenterによってクラスター内の2番目のノードが選択されます。データ・センター名にlocal_dc_prefを指定すると、OpsCenterが2番目のノードを選択するときにそのデータ・センターを使用するよう強制できます。
[storage_cassandra] used_hosts_per_remote_dc
OpsCenterストレージに別のクラスターを使用する場合に構成します。local_dc_prefを使用する場合に、フォールバックとして使用されるリモートDC接続数を指定します。デフォルト値は1です。
[storage_cassandra] connect_timeout
OpsCenterストレージに別のクラスターを使用する場合に構成します。OpsCenterからCassandraへのThrift接続のタイムアウトを秒単位で設定します。デフォルト値は6.0です。
[storage_cassandra] host_read_timeout_ms
データのクエリなど、CQL読み取り操作時にホストが応答しないと見なされるまでのタイムアウト値(ミリ秒)。このタイムアウト値は、Cassandra側(read_request_timeout_in_ms in cassandra.yaml)で使用されるタイムアウト設定より高い値を設定する必要があります。デフォルト:DataStax Java Driverのデフォルト値。
[storage_cassandra] bind_interface
OpsCenterストレージに別のクラスターを使用する場合に構成します。Thrift接続に使用されるインターフェイス。
[storage_cassandra] connection_pool_size
OpsCenterストレージに別のクラスターを使用する場合に構成します。接続プール用に作成するThrift接続の数。デフォルト値は5です。
[storage_cassandra] username
OpsCenterストレージに別のクラスターを使用する場合に構成します。認証が有効になっている場合に、Cassandraへの接続に使用するユーザー名。
[storage_cassandra] password
OpsCenterストレージに別のクラスターを使用する場合に構成します。認証が有効になっている場合に、Cassandraへの接続に使用するパスワード。
[storage_cassandra] send_rpc
OpsCenterストレージに別のクラスターを使用する場合に構成します。Cassandra RPC IPをDataStaxエージェントに送信するかどうかを指定します。デフォルト値はTrueです。
[storage_cassandra] keyspace
OpsCenterデータに使用されるキースペースの名前。キースペース名は、管理対象のクラスターごとに一意である必要があります。
[storage_cassandra] ssl_keystore
Cassandraに直接接続するために使用するOpsCenterのSSLキーストアの場所。
[storage_cassandra] ssl_keystore_password
Cassandraに直接接続するために使用するOpsCenterのSSLキーストアのパスワード。
[storage_cassandra] ssl_truststore
Cassandraに直接接続するために使用するOpsCenterのSSLトラストストアの場所。
[storage_cassandra] ssl_truststore_password
Cassandraに直接接続するために使用するOpsCenterのSSLトラストストアのパスワード。
[storage_cassandra] schema_refresh_interval
スキーマ変更コマンドの発行後にスキーマの更新を待機する時間(ミリ秒)。このオプションはopscenterdに適用されないさまざまなスキーマ作成ツールとともに使用されるため、間隔はデフォルト値0のままにしておく必要があります。
[collection] basic_info_period
CassandraがCassandra APIの更新をチェックする間隔(秒)。デフォルト値は3600(1時間)です。
[collection] nodelist_poll_period
OpsCenterがクラスター内のノードのポーリングを待機する間隔(秒)。デフォルト値は30です。
[collection] job_poll_period
Job Trackerをポーリングする間隔(秒)。デフォルト値は5です。
[collection] cf_poll_period
スキーマの更新をチェックする間隔(秒)。デフォルト値は60です。
[collection] push_throttle_period
ノード情報をUIにプッシュする間隔(秒)。デフォルト値は60です。
[metric_caching] num_data_points_cached
クラスター・メトリクス用にキャッシュするデータ・ポイントの数。デフォルト値は50です。
[metric_caching] num_metrics_cached
クラスター・メトリクス用にキャッシュするメトリクスの数。デフォルト値は1000です。
[agents] api_port
DataStaxエージェントで使用されるHTTPトラフィックのポート。デフォルト・ポートは61621です。
[agents] http_timeout
エージェントへのHTTP呼び出しのタイムアウト(秒)。デフォルト値は10です。
[agents] ssl_keystore
監視対象クラスターでCQLに接続するために使用するDataStaxエージェントのSSLキーストアの場所。
[agents] ssl_keystore_password
監視対象クラスターでCQLに接続するために使用するDataStaxエージェントのSSLキーストアのパスワード。
[agents] ssl_truststore
信頼できる証明書に使用するDataStaxエージェントのSSLトラストストアの場所。
[agents] ssl_truststore_password
信頼できる証明書に使用するDataStaxエージェントのSSLトラストストアのパスワード。
[agents] storage_ssl_keystore
ストレージ・クラスターでCQLに接続するために使用するDataStaxエージェントのSSLキーストアの場所。
[agents] storage_ssl_keystore_password
ストレージ・クラスターでCQLに接続するために使用するDataStaxエージェントのSSLキーストアのパスワード。
[agents] storage_ssl_truststore
ストレージ・クラスターで信頼できる証明書に使用するDataStaxエージェントのSSLトラストストアの場所。
[agents] storage_ssl_truststore_password
ストレージ・クラスターで信頼できる証明書に使用するDataStaxエージェントのSSLトラストストアのパスワード。
[agents] ec2_metadata_api_host
インスタンスIDなどのEC2メタデータを取得するためのIPアドレス。デフォルトのIPアドレスは169.254.169.254です。
[agents] concurrent_agent_requests
OpsCenterが大部分のHTTP操作のためにDataStaxエージェントに対して行う同時HTTP要求の数。デフォルト値は10です。
[agents] concurrent_settings_requests
OpsCenterが起動時または新しいクラスターの追加時にDataStaxエージェントが同時に接続する数。デフォルト値は10です。
[agents] concurrent_snapshot_list_requests
スナップショット情報の同時取得要求の数。デフォルト値は1です。
[agents] snapshot_wait
「[cassandra] snapshot_threshold」を参照してください。
[agents] remote_backup_region
リモート・バックアップ/復元のために接続するS3リージョン。デフォルト値はus-west-1です。
[agents] backup_staging_dir
このパスは、Cassandraによってコミット・ログがアーカイブされるディレクトリーを指定します。ここから、コミットログが構成済みのデスティネーションとbackup_storage_dirに送信されます。
[agents] backup_storage_dir
このパスは、各ノードでコミット・ログを格納して保持するディレクトリーを指定します。コミット・ログ・アーカイブを有効にする前に、このプロパティを設定する必要があります。
[agents] restore_req_update_period
復元中にOpsCenterに進行状況を報告する間隔(秒)。デフォルト値は、クラスターのサイズに基づいて自動的に計算されます。パフォーマンスを最適化するため、クラスターが大きいほど復元の進行状況がUIに送信されるしきい値が大きくなります。復元中に最新情報を取得する間隔を変更するには、このプロパティを構成します。注:数値を小さくすると、復元中にパフォーマンスに影響を及ぼす可能性があります。
[agents] diagnostic_tarball_download_timeout
エージェントから診断用tarボールをダウンロードしようと試行する最大時間(秒)。処理速度の遅いマシンや複数インスタンスのクラスターでは、この値を大きくしなければならない場合があります。デフォルト値:120。
[cassandra_metrics] ignored_keyspaces
メトリクスを収集しないキースペースのコンマ区切りリスト。デフォルト値は、systemsystem_tracessystem_authdse_authOpsCentersystem_views、およびsystem_virtual_schemaです。
[cassandra_metrics] ignored_column_families
メトリクスを収集しないテーブルのコンマ区切りリスト。各エントリーは「ks.cf」という形式にする必要があります。例を次に示します。metrics_ignored_column_families = system.NodeInfo, system.Schema, Keyspace1.Standard1
[cassandra_metrics] ignored_solr_cores
メトリクスを収集しないSolrコアのコンマ区切りリスト。各エントリーは「ks.cf」という形式にする必要があります。例を次に示します。metrics_ignored_solr_cores = Keyspace1.Standard1, solr.wiki
[cassandra_metrics] 1min_ttl
1分のデータ・ポイントが期限切れになるまでの時間(秒)を設定します。デフォルト値は604800(7日間)です。
[cassandra_metrics] 5min_ttl
5分のデータ・ポイントが期限切れになるまでの時間(秒)を設定します。デフォルト値は2419200(28日間)です。
[cassandra_metrics] 2hr_ttl
2時間のデータ・ポイントが期限切れになるまでの時間(秒)を設定します。デフォルト値は31536000(365日間)です。
[cassandra_metrics] 24hr_ttl
24時間のデータ・ポイントが期限切れになるまでの時間を設定します。デフォルト値は0、つまり期限切れになりません。
[cassandra_metrics] metrics_enabled
DataStaxエージェントがCassandraメトリクスを収集するかどうかを指定します。デフォルト値はTrueです。
[event_storage] enabled
OpsCenterイベントをイベント・ストアに記録するかどうかを指定します。デフォルト値はTrueです。
[spark] master_http_port
SparkマスターUIが公開されるポート。デフォルトは7080です。
[spark] master_proxy_port
Sparkプロキシ・ポートの計算値のオーバーライド。
[kerberos] default_service
デフォルトのKerberosサービス名(cassandraなど)。
[kerberos] default_hostname
デフォルトのKerberosホスト名。
[kerberos] default_client_principal
デフォルトのKerberosクライアント・プリンシパル(cassandra@realmなど)。
[kerberos] default_client_user
デフォルトのKerberosクライアント・ユーザー。
[kerberos] opscenterd_client_principal
KerberosのOpsCenterクライアント・プリンシパル(user@realmなど)。
[kerberos] opscenterd_keytab_location
OpsCenterマシン上のopscenterd_client_principalのキーを含むキータブのフル・パス。
[kerberos] agent_client_principal
KerberosのDataStaxエージェント・クライアント・プリンシパル(user@realmなど)
[kerberos] agent_keytab_location
DataStaxエージェント・マシン上のagent_client_principalのキーを含むキータブのフル・パス。
[kerberos] debug
OpsCenterからKerberos接続を試行中にデバッグ・メッセージを出力するかどうかを指定します。
[stomp] batch_size
OpsCenterが一度にプッシュする要求の更新数。デフォルト値は100です。ブラウザーの過負荷を防ぐために使用されます。
[stomp] push_interval
OpsCenterが要求の更新をプッシュする間隔。デフォルト値は3秒です。ブラウザーの過負荷を防ぐために使用されます。
[stomp] alert_push_interval
OpsCenterがアラートの更新をプッシュする間隔。デフォルト値は1秒です。ブラウザーの過負荷を防ぐために使用されます。
[bestpractice] results_ttl
OpsCenterがBest Practice Service(ベスト・プラクティス・サービス)の実行結果を格納する期間(秒)。デフォルト値は2,419,200秒、つまり4週間です。
[forecasting] range_multiplier
予測を生成するために必要なクエリー範囲の乗数。デフォルトの乗数は3です。
[forecasting] required_data_percentage
予測に必要な過去データの最小割合(%)。デフォルト値は0.5です。
[backups] restore_init_throttle
OpsCenterが復元プロセスを同時に開始するDataStaxエージェントの数。デフォルト値は20です。
[backups] restore_sleep
OpsCenterがrestore_init_throttleで設定された復元プロセス開始のバッチ間にスリープする時間。デフォルト値は5秒です。
[backups] failure_threshold
リモート・デスティネーション復元アクションが失敗と見なされるまでにクラスターが応答に失敗する割合(%)。デフォルト:50。
[labs] graphite_host
graphite_hostを設定すると、指定されたアドレスのGraphiteサーバーにメトリクスを転送できます。graphite_hostを空白にすると、Graphiteサーバーへのメトリクスの転送が無効になります。
[labs] graphite_port
Graphiteのプレーンテキスト・プロトコルのポート。
[labs] graphite_prefix
メトリクスを挿入するプレフィックス。
[labs] bypass_dse_metrics_storage
監視対象のDSEクラスターまたは別のストレージDSEクラスターへのメトリクスの格納を有効または無効にします。デフォルトでは、メトリクスはDSEの監視対象のクラスターまたはストレージ・クラスターに格納されます。デフォルト:False。
[labs] use_s3_cli
バックアップをAmazon S3の場所に一括読み込みするときに、AWS SDKではなくAWS CLIの使用を有効にします。デフォルト:False。
[kerberos_hostnames] 192.168.1.101
サービス(DSE)のKerberosホスト名のノードごとの指定。IPとホスト名のペアのリスト。たとえば、192.168.1.101 = cassandra01.example.comのようになります。
[kerberos_services] 192.168.1.101
Kerberosサービス名のノードごとの指定。IPとホスト名のペアのリスト。たとえば、192.168.1.101 = cassandraのようになります。
[kerberos_client_principals] 192.168.1.102
使用するKerberosプリンシパルのクライアントごとの指定。IPとホスト名のペアのリスト。たとえば、192.168.1.102 = opscenter-agent01@EXAMPLE.COMのようになります。
[cluster_display_options] display_name
このクラスターを示すためにOpsCenterで使用される表示名。