Memcachedモニタリングの統合

当社のMemcached 統合は、お客様のMemcachedインスタンスからインベントリとメトリクスを収集して当社のプラットフォームに送信し、主要なパフォーマンス・メトリクスを集約して視覚化することができます。インスタンスとスラブの両方のレベルでデータを収集します。

インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。

互換性および要件

当社の統合は、Memcached 1.4以上と互換性があります。

MemcachedがKubernetesまたはAmazonECSで実行されていない場合は、Memcachedを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。さもないと：

Kubernetesで実行されている場合は、これらの要件をご覧ください。
ECSで実行されている場合は、これらの要件をご覧ください。

クイックスタート

ガイド付きインストールにより、Memcached インスタンスを迅速にインスツルメンテーションし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズしたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。

始める準備はできていますか？ボタンの1つをクリックし、試行してください。

ガイド付きインストール

EUガイド付きインストール

ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してMemcachedとの統合を設定します。それだけでなく、あなたの環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨します。

ガイド付きインストールは、ほとんどのセットアップで機能します。しかし、ニーズに合わない場合は、以下の他の方法でMySQLインスタンスの監視を始めることができます。

インストールと有効化

Memcachedインテグレーションをインストールするには、お使いの環境に応じた指示に従ってください。

' '

インテグレーションのインストールの指示に従ってください。ファイル名は nri-memcached です。
ディレクトリをintegrationsフォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```
サンプルの設定ファイルのコピー：
```
sudo cp memcached-config.yml.sample memcached-config.yml
```
memcached-config.yml ファイルを構成設定で説明されているように編集します。
Infrastructureエージェントを再起動します。

nri-memcached .MSIインストーラーイメージを以下からダウンロードしてください。
http://download.newrelic.com/infrastructure_agent/windows/integrations/nri-memcached/nri-memcached-amd64.msi

インストールするには、Windowsのコマンドプロンプトで次のコマンドを実行します。

msiexec.exe /qn /i PATH\TO\nri-memcached-amd64.msi

インテグレーションのディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、以下を実行してサンプル設定ファイルのコピーを作成します。
```
cp memcached-config.yml.sample memcached-config.yml
```
memcached-config.yml 構成ファイルを構成設定を使って編集する.
Infrastructureエージェントを再起動します。

追加の注：

アドバンスト：インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。
オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インテグレーションの設定

インテグレーションのYAML形式設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。

インストールの方法により、インテグレーションの設定方法はいくつかあります。

Kubernetesで有効化した場合：Kubernetes上で実行中のサービスの監視を参照してください。
Amazon ECSで有効化した場合：ECS上で実行中のサービスの監視を参照してください。
オンホストでインストールされている場合：統合のYAML設定ファイル（ memcached-config.yml）の設定を編集します.

この設定ファイルには、 interval 、 timeout 、 inventory_source など、すべてのインテグレーションで使用される共通の設定が含まれています。これらの共通設定の詳細については、 Configuration properties list をご覧ください。

従来の設定/定義ファイルをまだお使いの場合は、標準設定フォーマットを参照してください。

Memcached に関連する特定の設定は、構成ファイルの env セクションを使用して定義されます。これらの設定は、Memcached インスタンスへの接続や、その他のセキュリティ設定および機能を制御します。

設定オプションは以下のとおりです。実際にどのように動作するかについては、のサンプル設定ファイルを参照してください。

Memcachedインスタンスの設定

Memcachedの統合では、Metrics( M )とInventory( I )の両方の情報を収集します。 Applies To カラムをチェックして、各コレクションに使用できる設定を確認してください。

' ' ' ' ' ' ' ' ' '

設定	説明	デフォルト	適用先
HOST	memcachedインスタンスのホスト名。	localhost	M/I
ポート	memcachedが動作しているポート。	11211	M/I
ユーザー名	Memcached SASL ユーザー名。認証が有効な場合のみ必要です。	該当なし	M/I
パスワード	Memcached SASL パスワード。認証が有効な場合のみ必要です。	該当なし	M/I
メトリクス	`true` に設定すると、Metrics-only の収集が有効になります。	false
インベントリ	`true` に設定すると、Inventory-only collection が有効になります。	false

これらの設定値は、いくつかの方法で定義できます。

コンフィグファイルに直接値を追加します。
{{}} 表記を使用して、環境変数から値を置き換えます。これには、Infrastructure agent v1.14.0+が必要です。詳細はこちらまたは下記の例をご覧ください。
パスワードなどの機密情報が設定ファイルに平文で表示されないようにするには、secrets managementを使用します。詳しくは、 secrets management の使い方をご覧ください。

ラベル/カスタム属性

また、ラベルを使ってメトリクスを装飾することもできます。このような場合は、次のようになります。これにより、メトリクスのクエリ、フィルタリング、グループ化に使用できます。

デフォルトのサンプル設定ファイルには、ラベルの例が含まれていますが、お好みでラベルを削除、変更、追加することができます。

labels:
   env: production
   role: memcached

構成例

例 memcached-config.yml ファイルの設定。

integrations:
  - name: nri-memcached
    env:
      PORT: "11211"
      HOST: memcached_host

      # ifauthentication is enabled.
      USERNAME: cacheuser
      PASSWORD: password
    interval: 15s
    inventory_source: config/memcached

オンホストの統合設定の一般的な構造については、 our integration configuration overview を参照してください。

データの検索と使用

このサービスからのデータは、インテグレーションダッシュボードにレポートされます。

メトリクスは、これらのイベントタイプに付けられています。

MemcachedSample
MemcachedSlabSample

トラブルシューティング目的で、またはカスタムのチャートとダッシュボードを作成するために、このデータのクエリを行えます。

データの検索・使用方法の詳細については、インテグレーションデータを理解するを参照してください。

メトリックデータ

Memcachedインテグレーションでは、以下のメトリックデータ属性を収集します。

Memcached サンプルメトリクス

これらの属性は、この MemcachedSample イベントタイプに付けられています。

メトリック	説明
`avgItemSizeInBytes`	アイテムの平均的なサイズです。
`bytesReadServerPerSecond`	このサーバーがネットワークから読み取ったバイト数。
`bytesUsedServerInBytes`	このサーバーがアイテムの保存に使用している現在のバイト数。
`bytesWrittenServerPerSecond`	このサーバーがネットワークに書き込んだバイト数。
`casHitRatePerSecond.`	キーを比較し、交換し、存在を確認する割合。
`casMissRatePerSecond`	キーが比較され、交換され、存在が発見されない率。
`casWrongRatePerSecond`	元の値と提供された値が一致しない場合に、キーを比較して交換する割合。
`cmdFlushRatePerSecond`	`flushall` コマンドの割合。
`cmdGetRatePerSecond`	`get` コマンドの割合。
`cmdSetRatePerSecond`	`セット` コマンドの割合。
`connectionRateServerPerSecond`	このサーバーへの接続が開かれる割合。
`connectionStructuresAllocated`	サーバーが割り当てた接続構造体の数。
`currentItemsStoredServer`	サーバーに保存されている現在のアイテム数。
`deleteCmdNoneRemovedPerSecond`	削除コマンドの結果、アイテムが削除されなかった割合。
`deleteCmdRemovedPerSecond`	削除コマンドの結果、アイテムが削除された割合。
`evictionsPerSecond`	新しいアイテムのためのメモリを確保するために、有効なアイテムがキャッシュから削除される割合。
`実行時間`	CPUがこのサーバープロセスの実行に費やしたユーザータイムの割合。
`getHitPercent`	リクエストされたキーのうち、memcache サーバーの開始以降に存在が確認されたキーの割合です。
`getHitPerSecond`	鍵が要求され、見つかった割合。
`getMissPerSecond`	キーを要求しても見つからない率。
`limitBytesStorage`	このサーバーがストレージに使用することを許可されるバイト数。
`openConnectionsServer`	このサーバーに対するオープンコネクションの数。
`ポインタサイズ`	ホストOSのポインターのデフォルトサイズ（通常は32または64）。
`serverMaxConnectionLimitPerSecond`	サーバーが最大接続数に達した率
`ストアリングItemsPercentMemory`	アイテムを保存するためにサーバーが使用しているメモリの量を、最大許容値に対する割合で示したもの。
`スレッド`	現在のMemcachedサーバ・プロセスで使用されているスレッド数。
`totalItemsStored`	このサーバーが起動してから保存されているアイテムの合計数。
`uptimeInMilliseocnds`	このサーバーが稼働している秒数。
`使用率`	CPUがこのサーバープロセスに代わってカーネルコードを実行するのに費やした時間の割合。

Memcached slab サンプルメトリクス

これらの属性は、 MemcachedSlabSample イベントタイプに付けられています。

メトリック	説明
`activeItemsBumpedPerSecond`	`HOT` または `WARM` 内でアクティブなアイテムがバンプされた率。
`アクティブスラブ`	割り当てられたスラブクラスの総数
`casBadValPerSecond`	CAS IDの不良により、Check-And-Set（CAS）コマンドが値の変更に失敗した割合。
`casModifiedSlabPerSecond`	CASコマンドがこのスラブクラスを変更する割合。
`chunkSizeInBytes`	各チャンクが使用するスペースの量です。
`chunksPerPage`	1ページの中に何個のチャンクが存在するか。
`cmdSetRateSlabPerSecond`	このスラブ・クラスでセット・リクエストが保存されたデータの割合。
`decrsModifySlabPerSecond`	decrsコマンドがこのスラブクラスを変更する割合。
`deleteRateSlabPerSecond`	このスラブクラスで削除コマンドが成功した率。
`EntryReclaimedPerSecond`	期限切れのエントリーのメモリを使ってエントリーが保存された割合。
`evictionsBeforeExpirationPerSecond`	期限切れになる前に、LRU（Least Recently Used）からアイテムを退避させなければならない率。
`evictionsBeforeExplicitExpirationPerSecond`	明示的に有効期限が設定されている非ゼロアイテムが、有効期限が切れる前にLRUから退避する必要がある割合。
`expiredItemsReclaimedPerSecond`	設定されてから一度も触られなかった期限切れのアイテムをLRUから回収する割合。
`freeChunksEnd`	最後に割り当てられたページの終わりにあるフリーチャンクの数。
`解放されたチャンク`	まだアイテムに割り当てられていないチャンクや、deleteで解放されていないチャンク。
`getHitRateSlabPerSecond`	このスラブ・クラスでゲット・リクエストが処理された率。
`incrsModifySlabPerSecond`	incrsコマンドがこのスラブクラスを変更する割合。
`itemsCold`	`COLD` LRU に現在格納されているアイテムの数。
`itemsColdPerSecond`	`HOT` または `WARM` から `COLD` にアイテムが移動された率。
`itemsDirectReclaimPerSecond`	ワーカースレッドが新しいアイテムのためのメモリを見つけるために、LRUのテールを直接引く必要があった割合。
`itemsFreedCrawlerPerSecond`	LRUクローラーがアイテムを解放する割合。
`itemsHot`	`HOT` LRU に現在格納されているアイテムの数。
`itemsOldestInMilliseconds`	LRUの中で最も古いアイテムの年齢。
`itemsRefcountLockedPerSecond`	リファクタリングされたアイテムがLRUテールにロックされる割合。
`itemsSlabClass`	このスラブクラスに現在収納されているアイテムの数。
`itemsTimeSinceEvictionInMilliseconds`	このスラブクラスから退避した最新のアイテムの、最後のアクセスからの秒数をミリ秒単位で表示しています。
`itemsWarm`	`WARM` LRU に現在格納されているアイテムの数。
`itemsWarmPerSecond`	`COLD` から `WARM` へアイテムが移動した割合。
`memAllocatedSlabsInBytes`	スラブページに割り当てられたメモリの総量。
`memRequestedSlabInBytes`	このスラブに格納されるように要求されたバイト数。
`outOfMemoryPerSecond`	根本的なスラブクラスが新しいアイテムを保存できなかった率をエラーとして表示しています。
`セルフヒーリングスラブパーセコンド`	refcount のリークがあるスラブを memcache が自己修復する割合。
`トータルチャンクススラブ`	スラブクラスに割り当てられたチャンクの合計数。
`トータルページスラブ`	スラブクラスに割り当てられた総ページ数。
`touchHitSlabPerSecond`	このスラブクラスでサービスされるタッチの割合。
`usedChunksItems`	アイテムに割り当てられたチャンクの数。
`usedChunksPerSecond`	アイテムにチャンクが割り当てられた割合。
`validItemsEvictedPerSecond`	設定されてから一度もタッチされなかった有効なアイテムをLRUから退避させる割合。

インベントリデータ

Memcached 統合は、memcached インスタンスの構成パラメータを取得します。このデータは、 Inventory ページ、 config/memcached ソースの下にあります。インベントリデータの詳細については、 Understand integration data を参照してください。

この統合では、以下のMemcached構成パラメータのデータを取得します。

Memcachedの在庫

メトリック	説明
`auth_enabled_sasl`	SASL認証が有効であるかどうかを示す。
`バインディング・プロトコル（Binding_Protocol`	クライアント接続のデフォルトのプロトコルサポートを設定します。オプション： `ascii`, `binary`, または `auto/.デフォルトです。オート`
`cas_enabled`	CAS（Check-And-Set）が有効であるかどうかを示す。
`chunk_size`	各チャンクが使用するスペースの量です。1つのアイテムは、適切なサイズの1つのチャンクを使用します。
`detail_enabled`	stats detailが有効であるかどうかを示す。
`ドメインソケット`	リッスンするUNIXソケットへのパスです。
`dump_enabled`	stats cachedump および `lru_crawler` metadump が有効であるかどうかを示します。
`立ち退き`	エビエーションが有効であるかどうかを示します。有効であれば、メモリが枯渇したときに、退避せずにエラーを返します。
`flush_enabled`	`flush_all` コマンドが有効であるかどうかを示す。
`growth_factor`	チャンクサイズの成長因子です。
`hash_algorithm`	ハッシュテーブルのアルゴリズムです。
`hashpower_init`	ハッシュテーブルの大きさを決める整数倍の値です。通常、実行時に大きくなります。
`hot_lru_pct`	HOT LRUのために確保するスラブメモリの割合。
`ホット_マックス_ファクター`	HOT LRU のアイドル年齢を COLD 年齢にこの値を乗じた値に設定します。
`idle_timeout`	アイドル接続のタイムアウト。
`inline_ascii_response`	1アイテムにつき最大24バイトの保存が可能です。
`インター`	リッスンするインターフェイスです。
`アイテム_サイズ_マックス`	アイテムの最大サイズです。
`lru_crawler`	LRUクローラーのバックグラウンドスレッドを有効にします。
`lru_crawler_sleep`	マイクロ秒単位でアイテム間のスリープを行います。
`lru_crawler_tocrawl`	スラブごとにクロールできる最大のアイテム数。
`lru_maintainer_thread`	LRUモードとバックグラウンドスレッドの分割
`LRU_SEGEGED`	セグメント化されたLRUモードを有効にする。
`maxbytes`	キャッシュに入れることができる最大のバイト数です。
`maxconns`	許可されるクライアントの最大数。
`maxconns_fast`	制限に達した後、新しい接続を直ちに閉じます。
`num_threads`	使用するスレッドの数
`num_threads_per_udp`	UDPごとに使用するスレッドの数。
`最古`	最も古い名誉あるオブジェクトの年齢です。
`reqs_per_event`	1イベントあたりの最大リクエスト数
`スラブ・オートムーブ`	スラブページオートオーバーが有効であるかどうかを示す。
`スラブオートムーブの比率`	若年層/老年層のスラブクラスの比率制限。
`スラブ_オートムーブ_ウィンドウ`	自動運転のために調整可能な内部アルゴリズム
`スラブ_チャンク_マックス`	スラブの最大サイズを指定します。設定した最大値よりも大きいアイテムは、複数のスラブに分割されます。
`slab_reassign`	スラブの再配置を有効または無効にします。
`stat_key_prefix`	スタッツキーに使用されるプレフィックスです。
`tail_repair_time`	LRUのテールアイテムを強制的に削除するまでの待ち時間を秒単位で指定します。
`tcp_backlog`	バックログのキューの上限です。
`tcpport`	リッスンするTCPポートです。
`temp_lru`	ブール値で、 `temporary_ttl` が `temp_lru` を使用するかどうかを示します。
`temporary_ttl`	この値よりも低いTTLで設定されたアイテムは、TEMP_LRUに入り、期限切れや削除・交換されるまで回避不能となります。TTL が 0 に設定されている場合、TEMP_LRU は無効です。
`トラックサイズ`	stats sizes」コマンドのダイナミックレポーターを有効にする。
`udpport`	リッスンするUDPポートです。
`umask`	UNIXソケットのアクセスマスクを8進数で指定します。
`饒舌`	`0` = none, `1` = some, `2` = lots... ロギング出力の冗長度を設定します。
`温暖化_lru_pct`	WARM LRUのために確保するスラブメモリの割合。
`ウォーム・マックス・ファクター`	WARM LRU のアイドル年齢を COLD 年齢にこの値を乗じた値に設定します。
`ウォッチャー_ログバフ_サイズ`	ウォッチャーごとの書き込みバッファのサイズ（キロバイト単位）。
`ワーカー・ログバフ・サイズ`	ワーカースレッドごとのバッファのサイズをキロバイト単位で指定します。

ソースコードのチェック

このインテグレーションは、オープンソース・ソフトウェアです。つまり、そのソースコードを閲覧して改良を送ったり、独自のフォークを作成して構築することができます。

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。