診断ログを表示する (SharePoint Foundation 2010)
適用先: SharePoint Foundation 2010
Microsoft SharePoint Foundation 2010 の ULS (Universal Logging System) ログのデータを使用すると、ファーム内で発生する問題のトラブルシューティングを行えます。ULS ログでは、ログ設定に応じて、さまざまなレベルのデータを収集できます。Windows PowerShell を使用して、データをフィルター処理し、それをさまざまな方法で表示したり、そのデータをデータ グリッドに出力したりできます。データ グリッドを使用すると、データのフィルター処理、並べ替え、グループ化、および Microsoft Excel 2010 へのエクスポートができます。
詳細については、「診断ログ設定を構成する (SharePoint Foundation 2010)」を参照してください。
Windows PowerShell を使用してログ イベントの表示とフィルター処理を行う
Windows PowerShell を使用すると、ログ イベントの表示とフィルター処理を行えます。サーバーの全体管理では、ログ イベントの表示やフィルター処理は行えません。
Windows PowerShell を使用してログ イベントの表示とフィルター処理を行うには
次の最小要件を満たしていることを確認します。Add-SPShellAdmin を参照してください。
[スタート] メニューの [すべてのプログラム] をクリックします。
[Microsoft SharePoint 2010 Products] をクリックします。
[SharePoint 2010 管理シェル] をクリックします。
Windows PowerShell のコマンド プロンプトで、次のコマンドのうちの 1 つを入力します。
すべてのトレース イベント:
Get-SPLogEvent
レベル別:
Get-SPLogEvent | Where-Object {$_.Level -eq [Information | Warning | Error | Critical | Verbose | Unexpected | Monitorable | High | Medium]}
エリア別:
Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}
<Area> には Area プロパティの値を指定します。
カテゴリ別:
Get-SPLogEvent | Where-Object {$_.Category -eq <Category>
<Category> には Category プロパティの値を指定します。
イベント ID 別:
Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}
<EventID> には EventID プロパティの値を指定します。
メッセージ テキスト別:
Get-SPLogEvent | Where-Object {$_.Message -like "*<string>*"}
<string> には、イベント メッセージ内の文字列を指定します。
プロセス別:
Get-SPLogEvent | Where-Object {$_.Process -like "*<Process>*"}
<Process> には Process プロパティの値を指定します。
ヒント
既定では、このコマンドは既定の ULS ログ フォルダーからデータを取得します。ネットワーク上の共有フォルダーにあるトレース イベントの表示とフィルター処理を行うには、Get-SPLogEvent コマンドレットの Directory パラメーターを使用してください。
各トレース イベントの詳細を表示するには、コマンドの末尾に Format-List を使用します。たとえば、「Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List
」のようにします。
詳細については、「Get-SPLogEvent」を参照してください。
注意
コマンドライン管理タスクを実行するときには Windows PowerShell を使用することが推奨されています。Stsadm コマンドライン ツールは推奨されていませんが、製品の以前のバージョンとの互換性をサポートするために含まれています。
Windows PowerShell Out-GridView コマンドレットを使用して診断ログの表示とエクスポートを行う
Windows PowerShell には、Windows PowerShell のコマンドで生成される表形式のデータを、フィルター処理可能で検索可能なデータ グリッドのウィンドウに表示する、強力で使いやすい機能があります。このグリッドを使用して、ログ イベントを表示したり、データに対して次の操作を行ったりできます。
データを任意の列でを並べ替える。
データをグループごとに表示する。
データをレベル、エリア、カテゴリ、メッセージ、イベント ID、またはタイムスタンプでフィルター処理する。
データから文字列を検索する。
未加工のデータ、並べ替え後のデータ、またはフィルター処理後のデータをスプレッドシートにエクスポートする。
注意
Out-GridView コマンドレットは、Format 動詞を使用するコマンドレットと併用できません。Out-GridView コマンドレットはオブジェクトを受け取りますが、Format 動詞を使用するコマンドレットは書式付きテキストのみを返します。ただし、Where-Object パイプラインを使用して、グリッド ビューに送られるデータを事前にフィルター処理できます。たとえば、「Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView
」のようにします。
グリッドに何百行も表示される場合は、処理に時間がかかることもあります。複雑なフィルター処理を行う場合は特にそうです。パフォーマンスを高めるには、データを Excel 2013 にエクスポートしてください。
詳細については、「Out-GridView」(https://go.microsoft.com/fwlink/?linkid=181248&clcid=0x411) および「Out-GridView Revisited (英語)」(https://go.microsoft.com/fwlink/?linkid=181249&clcid=0x411) (英語) を参照してください。
Windows PowerShell を使用して診断ログの表示とフィルター処理を行うには
次の最小要件を満たしていることを確認します。Add-SPShellAdmin を参照してください。
[スタート] メニューの [すべてのプログラム] をクリックします。
[Microsoft SharePoint 2010 Products] をクリックします。
[SharePoint 2010 管理シェル] をクリックします。
Windows PowerShell コマンド プロンプトで、次のコマンドを入力します。
Get-SPLogEvent | Out-GridView
結果をグループごとに表示するには、以下の操作を実行します。
列見出しを右クリックし、[グループごとに表示] をクリックし、結果のグループ分けに使用する値の列見出しをクリックします。
特定のグループを展開したり折りたたんだりするには、そのグループの名前の横にある矢印をクリックします。
グループ化を解除するには、列見出しを右クリックし、[グループごとに表示] をクリックします。
列を並べ替えるには、列見出しをクリックします。
特定の文字列を検索するには、その文字列を [検索] ボックスに入力します。検索はすべての列と行に対して行われます。その検索をクリアするには、[すべてクリア] をクリックします。
1 つの条件だけでデータをフィルター処理するには、[検索] ボックスに「<プロパティ名>:<値>」と入力します。たとえば、SharePoint Foundation 2010 によって生成されたすべてのログ エントリを検索するには、「Area:SharePoint Foundation」と入力します。フィルターをクリアするには、[すべてクリア] をクリックします。
複数の条件を使用するか、"次の値を含む"、"次の値で始まる"、"次の値で終わる"、またはその他の方法を使用して、データをフィルター処理するには、次の手順を実行します。
[クエリ] をクリックします。
[追加] をクリックします。
フィルター処理するプロパティのチェック ボックスをオンにし、[OK] をクリックします。
[次の値を含む] をクリックして、別のフィルター方法に変更します。使用できる方法は、[次の値を含む]、[次の値を含まない]、[次の文字列で始まる]、[次の値と等しい]、[次の値と等しくない]、[次の値で終わる]、[空である]、および [空でない] です。
テキスト ボックスに値を入力します。
手順 "c" で選択したプロパティごとに、手順 "e" と手順 "f" を繰り返します。
フィルター条件をすべて指定したら、検索ボタンをクリックして、データ グリッドをフィルター処理します。
特定のフィルターをクリアするには、[X] ボタンをクリックします。
すべてのフィルターをクリアするには、クエリ ビューを折りたたみ、[すべてクリア] ボタンをクリックします。
グリッド データをスプレッドシートにエクスポートするには
エクスポートする行を選択します。次の方法で複数の行を選択できます。行のブロックを選択するには、Shift キーを押しながらドラッグします。個々の行を選択するには、Ctrl キーを押しながらクリックします。すべての行を選択するには、Ctrl キーを押しながら A キーを押します。
データをスプレッドシートにコピーする前に、結果に対してフィルター処理と並べ替えを行うこともできます。データの並べ替えまたはフィルター処理を行った場合、表示可能なデータのみがコピーされます。
Ctrl + C キーを使用して、選択した行をコピーします。
スプレッドシート ブック ページを開き、Ctrl + V キーを使用して、コピーした行をそこに貼り付けます。
See Also
Concepts
診断ログ設定を構成する (SharePoint Foundation 2010)
監視の概要 (SharePoint Foundation 2010)