运用ドキュメントの分类と构造化
18 likes6,885 views
2012-01-18 EIC Communication Society Technical Committee on Internet Architecture See also http://rsh.csh.sh/operation-document/ (Operation Document Model)
![運用研究会 (2010年1月現在)
研究会メンバー
伊賀野 康生 (Verizon Business)!
谷津 航 (KDDI ネットワークオペレーションセンター)!
豊野 剛 (インターネットマルチフィード)!
中西 晶 (明治大学 経営学部 教授)!
波田野 裕一 (日本UNIXユーザ会 会長) [研究会主査]!
水越 一郎 (NTT東日本 ブロードバンドサービス部 サービス開発担当部長)!
村益 寛紀 (Telecom ISAC Japan ACCESS-WG主査，ソフトバンクBB)!
協力団体!
?財団法人日本データ通信協会 テレコム?アイザック推進会議 ACCESS-WG!
?日本UNIXユーザ会 (jus)](https://image.slidesharecdn.com/20120118-ia-operation-doc-140521010725-phpapp02/85/-6-320.jpg)
![参考: ドキュメントテーマによる価値 (仮説)
activity活動
変化
状
態
? 反復?再利用性の高いドキュメント(資産性ドキュメント)。!
? 「変化」「活動」の起点?終点となる最も重要なドキュメント"
? 何らかの形で売却できる場合「収益性」があると言える。
? 反復作成されるが再利用はしにくい。(費用性ドキュメント)!
? 「運用の費用対効果」を説明するためのドキュメントとなるた
め「収益性」があると考えることもできる。!
? 「活動」の蓄積が変化を生む。"
? [留意]「変化させない事」が重要とされる業務もある。
? 反復作成されるが再利用はしにくい。(費用性ドキュメント)!
? コストが直接配賦されれば「収益性」があるが、共通配賦され
る場合は、作成自体が「運用コスト」と評価される。
ドキュメントテーマ](https://image.slidesharecdn.com/20120118-ia-operation-doc-140521010725-phpapp02/85/-30-320.jpg)
运用ドキュメントの分类と构造化
- 1. 运用ドキュメントの分类と构造化 Classi?cation and structure of operation document 波田野 裕一 （運用研究会 / 日本UNIXユーザ会) 2012-01-18 EIC Communication Society Technical Committee on Internet Architecture
- 3. システム運用現場の諸問題 1. 高負荷 2. 属人的 3. 見えぬ費用対効果 Uncontrolable! 2009年
- 4. 運用現場の問題点解消のために 1. 高負荷 2. 属人的 3. 見えぬ費用対効果 運用現場の問題点 ブラックボックス化 低付加価値化 業務が複雑化 1. 業務の複雑化を許さない仕組み 作り 2. 業務のブラックボックス化を許 さない仕組み作り 3. 業務価値の陳腐化を許さない仕 組み作り 運用設計の目的運用方法論の目的 ? サービスの安定 社会基盤に相応しい安定運用。 ? 業務負荷の平準化 うまく業務が回る運用現場。 ? 運用に対する評価の適正化 適正な利潤を生む現場と、適切に評価される要員。 1.「運用」への期待の明確化 3. 期待に対する消費リソースの測定化 2.「運用設計」の確立 常にシンプル 常に見える 常に価値を生む 2010年
- 5. ? 運用ドキュメントと運用業務は表裏一体の関係にある。! ? ツールやスキルに対する的確な要求は、客観的なドキュメントがあってはじめて 実現可能となる。! ? ドキュメントのない業務は、存在しないことに近く、客観評価されない。! ? 事業の継続性は、ドキュメントがあってこそ確保可能となる。 運用ドキュメントの位置付け ドキュメントのない作業は、客観的には 「業務が存在しない」に等しい (Internet ?Week ?2009 ?「運用方法論」より) 「運用は忙しそうにしているけど、何やっているのかわからない」と言われてしまう。
- 6. 運用研究会 (2010年1月現在) 研究会メンバー 伊賀野 康生 (Verizon Business)! 谷津 航 (KDDI ネットワークオペレーションセンター)! 豊野 剛 (インターネットマルチフィード)! 中西 晶 (明治大学 経営学部 教授)! 波田野 裕一 (日本UNIXユーザ会 会長) [研究会主査]! 水越 一郎 (NTT東日本 ブロードバンドサービス部 サービス開発担当部長)! 村益 寛紀 (Telecom ISAC Japan ACCESS-WG主査，ソフトバンクBB)! 協力団体! ?財団法人日本データ通信協会 テレコム?アイザック推進会議 ACCESS-WG! ?日本UNIXユーザ会 (jus)
- 7. 今、運用ドキュメントが熱い ? 2010年11月 手順書友の会 発足 (JANOG系)! ? 2010年12月 jus勉強会! ? ドキュメントを作りたくなる魔法のツール Sphinx! ? 2011年6月 odstudy 発足 (インフラエンジニア系)
- 8. 道具もそろってきた ?手軽な分散バージョン管理システム" ? Mercurial" ?ドキュメントのための構造化言語" ? 構造化記法 reST + ドキュメントプロセッサ Sphinx" ? blockdiag" ?管理媒体" ? バグトラッキングシステム Redmine + リポジトリ連携
- 10. 発表の概要 (修正) 本論では、! ! 1. 記述対象による運用ドキュメントの分類、! 2. 分類を意識したドキュメントの構造化! ! を検討し、運用ドキュメントの作成維持工数の抑制および業務利便性向上の効果について定性的に考察する。 本論では、運用ドキュメントの作成維持工数の抑制および業務利便性向上のための! ! 1. 記述対象による運用ドキュメントの分類、! 2. 分類を意識したドキュメントの構造化! ! について考察する。 24時間365時間稼動を求められる現在の運用現場において、ドキュメント不足による属人化やスキルの偏在に よるトラブルの多発および特定メンバーの異動や退職による事業継続性リスクが課題となっている。
- 11. 分類と構造化の目的 ?アンドキュメンテッド運用からの脱却" ? 属人的(ブラックボックス/高負荷)運用からの脱却" ? クラウドに われない、運用の生き残り" ? 工学的視点に立つ高度な運用へ" ?100%手書き/属人的なドキュメント作成からの脱却" ? ITサービスの提供者がちゃんとITする(自動化)時代へ" ? 適切な自動化には構造化が、適切な構造化には類型化(分類)が必 要" ? 工学的視点に立つ高度なドキュメントロジックへ
- 13. 1. 運用ドキュメントとは
- 16. 運用ドキュメントの悩み ! ? 作られない/保守されない" ? 書かない! ! ? どこにあるかわからない" ? 読まない! ! ? 誰が管理しているかわからない" ? 管理できない!
- 19. 必要性が増していくドキュメント ? 業務の複雑化、変化の激化" ? 口伝で伝えるには限界を迎えている。(トラブル多発リスク)! ? グローバリゼーション & 均質社会からの変化" ? 空気を読むこと前提での業務は難しくなりつつある。(コミュニケーションの変質)! ? 強み(ノウハウ)の無い現場はクラウド/オフショアに食われていく。" ? 客観的なノウハウはドキュメントの上に積み上がっていく。 「今現在は困っていないから」とは、言うものの.... ドキュメントが無い事によるリスクが、かつてないほどに高まっている。 現場や自分達を守る?育てるために書く
- 22. 運用ドキュメント 2つ価値 1. 利用者から見た利用価値 (使ってナンボ)" 提供者から見た提供価値 (費用対効果)
- 25. 2. 提供価値 (運用ドキュメントの資産性?費用性) 反復利用、再利用性の高さと、陳腐化の早さに着目して、その運用 ドキュメントの価値属性(資産性、費用性)を評価することができる と考えられる。 資産性ドキュメント 費用性ドキュメント ? 反復利用?部品再利用性の高いドキュメント! ? 変更差分の継続更新により陳腐化回避を実現しているドキュメント ? 反復利用、部品再利用性の低いドキュメント! ? 差分更新の効果が低く、作成直後をピークに以後陳腐化していく ドキュメント
- 27. 1. 使う人の範囲" ? 自分、特定の現場、不特定多数" 2. 対象時間の範囲" ? 過去、現在、未来、普遍" 3. ドキュメントテーマ" ? 3類型 (状態 / 変化 / 活動) 運用ドキュメントに何を書くのか? 脱属人化 客観化 整理 記録 スコープ 目的 = 価値
- 29. ドキュメントテーマの3類型 時間軸 activity活動 状 態 変化前 変化後 変化 主観: De?ne (定義) " 状態分析 / 設計 / 要求" 客観: Status (状態)" スナップショット 主観: Activity (作業)" オペレーション / リリース " 客観: Event (事象)" ログ / インシデント 主観: Change (変更差分)" 変更分析 / 効果測定" 客観: Difference (変化)" 差分解析 / トレンド解析 主観: ヒト 客観: システム
- 30. 参考: ドキュメントテーマによる価値 (仮説) activity活動 変化 状 態 ? 反復?再利用性の高いドキュメント(資産性ドキュメント)。! ? 「変化」「活動」の起点?終点となる最も重要なドキュメント" ? 何らかの形で売却できる場合「収益性」があると言える。 ? 反復作成されるが再利用はしにくい。(費用性ドキュメント)! ? 「運用の費用対効果」を説明するためのドキュメントとなるた め「収益性」があると考えることもできる。! ? 「活動」の蓄積が変化を生む。" ? [留意]「変化させない事」が重要とされる業務もある。 ? 反復作成されるが再利用はしにくい。(費用性ドキュメント)! ? コストが直接配賦されれば「収益性」があるが、共通配賦され る場合は、作成自体が「運用コスト」と評価される。 ドキュメントテーマ
- 33. ドキュメント構造化の要素 文章ブロック単位での意味付け (見出し) 単位情報の責務の明確化 (オブジェクト化) ! 読み手が認識しやすい位置への文章ブロックの格納 (目次) 情報をツリー構造で表現 (構造化) ! 文章ブロック間の関係付け (クロスリファレンス) 情報内ネットワーク構造の構築 (ネットワーク化)
- 35. 6. まとめ
- 36. まとめ ? ITサービスの提供者がちゃんとITする(自動化)時代へ" ? 自動化には構造化が、構造化には類型化(分類)が必要" ? 工学的視点に立つ高度なドキュメントロジックへ ?アンドキュメンテッド運用からの脱却" ?手書き/属人的なドキュメントからの脱却
- 38. ドキュメントテーマの3類型 (再掲) 時間軸 activity活動 状 態 変化前 変化後 変化 主観: De?ne (定義) " 状態分析 / 設計 / 要求" 客観: Status (状態)" スナップショット 主観: Activity (作業)" オペレーション / リリース " 客観: Event (事象)" ログ / インシデント 主観: Change (変更差分)" 変更分析 / 効果測定" 客観: Difference (変化)" 差分解析 / トレンド解析 主観: ヒト 客観: システム