当社のMemcached 統合 は、お客様のMemcachedインスタンスからインベントリとメトリクスを収集して当社のプラットフォームに送信し、主要なパフォーマンス・メトリクスを集約して視覚化することができます。インスタンスとスラブの両方のレベルでデータを収集します。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社の統合は、Memcached 1.4以上と互換性があります。
MemcachedがKubernetesまたはAmazonECSで実行されていない場合は、Memcachedを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。さもないと:
クイックスタート
ガイド付きインストールにより、Memcached インスタンスを迅速にインスツルメンテーションし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズしたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。
始める準備はできましたか?これらのボタンのいずれかをクリックして試してください。
ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してMemcachedとの統合を設定します。それだけでなく、あなたの環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨します。
ガイド付きインストールは、ほとんどのセットアップで機能します。しかし、ニーズに合わない場合は、以下の他の方法でMySQLインスタンスの監視を始めることができます。
インストールしてアクティブ化する
Memcachedインテグレーションをインストールするには、お使いの環境に応じた指示に従ってください。
''
その他の注意事項:
- 高度:統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
- オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。
このドキュメントはインストールで役立ちましたか。
統合を構成する
統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。
インストール方法に応じて、統合を構成する方法はいくつかあります。
- Kubernetes経由で有効になっている場合: Kubernetesで実行されているサービスの監視をご覧ください。
- Amazon ECSを介して有効になっている場合: ECSで実行されている監視サービスを参照してください。
- ホストにインストールされている場合:統合のYAML構成ファイル
memcached-config.yml
の構成を編集します。
構成ファイルには、すべての統合で使用される共通の設定interval
、 timeout
、 inventory_source
など) があります。これらの一般的な設定の詳細については、 構成プロパティ リストを参照してください。
従来の設定/定義ファイルをまだお使いの場合は、 標準設定フォーマット を参照してください。
Memcached に関連する特定の設定は、構成ファイルのenv
セクションを使用して定義されます。これらの設定は、Memcached インスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。
設定オプションは以下のとおりです。実際にどのように動作するかについては、 のサンプル設定ファイル を参照してください。
Memcachedインスタンスの設定
Memcachedの統合では、Metrics( M )とInventory( I )の両方の情報を収集します。 Applies To カラムをチェックして、各コレクションに使用できる設定を確認してください。
'' '' '' '' ''
設定 | 説明 | デフォルト | に適用されます |
---|---|---|---|
亭主 | memcachedインスタンスのホスト名。 | ローカルホスト | M / I |
ポート | memcachedが動作しているポート。 | 11211 | M / I |
ユーザー名 | Memcached SASL ユーザー名。認証が有効な場合のみ必要です。 | 該当なし | M / I |
パスワード | Memcached SASL パスワード。認証が有効な場合のみ必要です。 | 該当なし | M / I |
METRICS | メトリックのみの収集を有効にするには、 | false | |
在庫 | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
- コンフィグファイルに直接値を追加します。
{{}}
表記を使用して、環境変数の値を置き換えます。これには、インフラストラクチャ エージェント v1.14.0 以降が必要です。ここで詳細を読むか、以下の例を参照してください。- パスワードなどの機密情報が設定ファイルに平文で表示されないようにするには、secrets managementを使用します。詳しくは、 secrets management の使い方 をご覧ください。
ラベル/カスタム属性
また、ラベルを使ってメトリクスを装飾することもできます。このような場合は、次のようになります。これにより、メトリクスのクエリ、フィルタリング、グループ化に使用できます。
デフォルトのサンプル設定ファイルには、ラベルの例が含まれていますが、お好みでラベルを削除、変更、追加することができます。
labels: env: production role: memcached
構成例
memcached-config.yml
ファイル構成の例:
オンホストの統合設定の一般的な構造については、 our integration configuration overview を参照してください。
データを見つけて使用する
このサービスからのデータは、 統合ダッシュボードに報告されます。
メトリックは、これらのイベントタイプに関連付けられています。
MemcachedSample
MemcachedSlabSample
トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
データを検索して使用する方法の詳細については、統合データについてを参照してください。
メトリックデータ
Memcachedインテグレーションでは、以下のメトリックデータ属性を収集します。
Memcached サンプルメトリクス
これらの属性は、このMemcachedSample
イベント タイプに関連付けられています:
メトリック | 説明 |
---|---|
| アイテムの平均的なサイズです。 |
| このサーバーがネットワークから読み取ったバイト数。 |
| このサーバーがアイテムの保存に使用している現在のバイト数。 |
| このサーバーがネットワークに書き込んだバイト数。 |
| キーを比較し、交換し、存在を確認する割合。 |
| キーが比較され、交換され、存在が発見されない率。 |
| 元の値と提供された値が一致しない場合に、キーを比較して交換する割合。 |
|
|
|
|
|
|
| このサーバーへの接続が開かれる割合。 |
| サーバーが割り当てた接続構造体の数。 |
| サーバーに保存されている現在のアイテム数。 |
| 削除コマンドの結果、アイテムが削除されなかった割合。 |
| 削除コマンドの結果、アイテムが削除された割合。 |
| 新しいアイテムのためのメモリを確保するために、有効なアイテムがキャッシュから削除される割合。 |
| CPUがこのサーバープロセスの実行に費やしたユーザータイムの割合。 |
| リクエストされたキーのうち、memcache サーバーの開始以降に存在が確認されたキーの割合です。 |
| 鍵が要求され、見つかった割合。 |
| キーを要求しても見つからない率。 |
| このサーバーがストレージに使用することを許可されるバイト数。 |
| このサーバーに対するオープンコネクションの数。 |
| ホストOSのポインターのデフォルトサイズ(通常は32または64)。 |
| サーバーが最大接続数に達した率 |
| アイテムを保存するためにサーバーが使用しているメモリの量を、最大許容値に対する割合で示したもの。 |
| 現在のMemcachedサーバ・プロセスで使用されているスレッド数。 |
| このサーバーが起動してから保存されているアイテムの合計数。 |
| このサーバーが稼働している秒数。 |
| CPUがこのサーバープロセスに代わってカーネルコードを実行するのに費やした時間の割合。 |
Memcached slab サンプルメトリクス
これらの属性は、 MemcachedSlabSample
イベントタイプに関連付けられています。
メトリック | 説明 |
---|---|
|
|
| 割り当てられたスラブクラスの総数 |
| CAS IDの不良により、Check-And-Set(CAS)コマンドが値の変更に失敗した割合。 |
| CASコマンドがこのスラブクラスを変更する割合。 |
| 各チャンクが使用するスペースの量です。 |
| 1ページの中に何個のチャンクが存在するか。 |
| このスラブ・クラスでセット・リクエストが保存されたデータの割合。 |
| decrsコマンドがこのスラブクラスを変更する割合。 |
| このスラブクラスで削除コマンドが成功した率。 |
| 期限切れのエントリーのメモリを使ってエントリーが保存された割合。 |
| 期限切れになる前に、LRU(Least Recently Used)からアイテムを退避させなければならない率。 |
| 明示的に有効期限が設定されている非ゼロアイテムが、有効期限が切れる前にLRUから退避する必要がある割合。 |
| 設定されてから一度も触られなかった期限切れのアイテムをLRUから回収する割合。 |
| 最後に割り当てられたページの終わりにあるフリーチャンクの数。 |
| まだアイテムに割り当てられていないチャンクや、deleteで解放されていないチャンク。 |
| このスラブ・クラスでゲット・リクエストが処理された率。 |
| incrsコマンドがこのスラブクラスを変更する割合。 |
|
|
| アイテムが |
| ワーカースレッドが新しいアイテムのためのメモリを見つけるために、LRUのテールを直接引く必要があった割合。 |
| LRUクローラーがアイテムを解放する割合。 |
|
|
| LRUの中で最も古いアイテムの年齢。 |
| リファクタリングされたアイテムがLRUテールにロックされる割合。 |
| このスラブクラスに現在収納されているアイテムの数。 |
| このスラブクラスから退避した最新のアイテムの、最後のアクセスからの秒数をミリ秒単位で表示しています。 |
|
|
| アイテムが |
| スラブページに割り当てられたメモリの総量。 |
| このスラブに格納されるように要求されたバイト数。 |
| 根本的なスラブクラスが新しいアイテムを保存できなかった率をエラーとして表示しています。 |
| refcount のリークがあるスラブを memcache が自己修復する割合。 |
| スラブクラスに割り当てられたチャンクの合計数。 |
| スラブクラスに割り当てられた総ページ数。 |
| このスラブクラスでサービスされるタッチの割合。 |
| アイテムに割り当てられたチャンクの数。 |
| アイテムにチャンクが割り当てられた割合。 |
| 設定されてから一度もタッチされなかった有効なアイテムをLRUから退避させる割合。 |
在庫データ
Memcached 統合は、memcached インスタンスの構成パラメータを取得します。このデータは、 Inventory ページ 、 config/memcached ソースの下にあります。インベントリデータの詳細については、 Understand integration data を参照してください。
この統合では、以下のMemcached構成パラメータのデータを取得します。
Memcachedの在庫
メトリック | 説明 |
---|---|
| SASL認証が有効であるかどうかを示す。 |
| クライアント接続のデフォルトのプロトコル サポートを設定します。オプション: |
| CAS(Check-And-Set)が有効であるかどうかを示す。 |
| 各チャンクが使用するスペースの量です。1つのアイテムは、適切なサイズの1つのチャンクを使用します。 |
| stats detailが有効であるかどうかを示す。 |
| リッスンするUNIXソケットへのパスです。 |
| 統計キャッシュダンプと |
| エビエーションが有効であるかどうかを示します。有効であれば、メモリが枯渇したときに、退避せずにエラーを返します。 |
|
|
| チャンクサイズの成長因子です。 |
| ハッシュテーブルのアルゴリズムです。 |
| ハッシュテーブルの大きさを決める整数倍の値です。通常、実行時に大きくなります。 |
| HOT LRUのために確保するスラブメモリの割合。 |
| HOT LRU のアイドル年齢を COLD 年齢にこの値を乗じた値に設定します。 |
| アイドル接続のタイムアウト。 |
| 1アイテムにつき最大24バイトの保存が可能です。 |
| リッスンするインターフェイスです。 |
| アイテムの最大サイズです。 |
| LRUクローラーのバックグラウンドスレッドを有効にします。 |
| マイクロ秒単位でアイテム間のスリープを行います。 |
| スラブごとにクロールできる最大のアイテム数。 |
| LRUモードとバックグラウンドスレッドの分割 |
| セグメント化されたLRUモードを有効にする。 |
| キャッシュに入れることができる最大のバイト数です。 |
| 許可されるクライアントの最大数。 |
| 制限に達した後、新しい接続を直ちに閉じます。 |
| 使用するスレッドの数 |
| UDPごとに使用するスレッドの数。 |
| 最も古い名誉あるオブジェクトの年齢です。 |
| 1イベントあたりの最大リクエスト数 |
| スラブページオートオーバーが有効であるかどうかを示す。 |
| 若年層/老年層のスラブクラスの比率制限。 |
| 自動運転のために調整可能な内部アルゴリズム |
| スラブの最大サイズを指定します。設定した最大値よりも大きいアイテムは、複数のスラブに分割されます。 |
| スラブの再配置を有効または無効にします。 |
| スタッツキーに使用されるプレフィックスです。 |
| LRUのテールアイテムを強制的に削除するまでの待ち時間を秒単位で指定します。 |
| バックログのキューの上限です。 |
| リッスンするTCPポートです。 |
| ブール値。 |
| この値よりも低いTTLで設定されたアイテムは、TEMP_LRUに入り、期限切れや削除・交換されるまで回避不能となります。TTL が 0 に設定されている場合、TEMP_LRU は無効です。 |
| stats sizes」コマンドのダイナミックレポーターを有効にする。 |
| リッスンするUDPポートです。 |
| UNIXソケットのアクセスマスクを8進数で指定します。 |
| ログ出力の詳細レベルを設定します。 |
| WARM LRUのために確保するスラブメモリの割合。 |
| WARM LRU のアイドル年齢を COLD 年齢にこの値を乗じた値に設定します。 |
| ウォッチャーごとの書き込みバッファのサイズ(キロバイト単位)。 |
| ワーカースレッドごとのバッファのサイズをキロバイト単位で指定します。 |
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。