サイトアイコン プログラマー(PG)・システムエンジニア(SE)になるための入門講座

保守担当者が困らない設計とは？IT初心者が知っておきたい保守しやすいシステムの考え方

pgse

保守担当者が困らない設計とは？IT初心者が知っておきたい保守しやすいシステムの考え方

結論から言うと、保守担当者が困らない設計とは、「障害が起きても原因を調べられる」「設定を安全に変更できる」「担当者が変わっても対応できる」状態を最初から作っておくことです。

システムはリリースしたら終わりではありません。実際のIT現場では、リリース後に不具合修正、設定変更、問い合わせ対応、OSやミドルウェアの更新、証明書更新、バックアップ、障害対応などが続きます。

開発担当者にとって分かりやすい構造でも、保守担当者から見ると「どこを直せばよいか分からない」「設定値がどこにあるか分からない」「変更したら何に影響するか分からない」ということがあります。

保守しやすいシステムを作るには、正常に動くことだけではなく、問題が起きた後にどう調査し、どう直し、どう元に戻すかまで考える必要があります。

  1. 保守担当者が困らない設計とは
  2. 運用と保守の違い
  3. なぜ保守担当者を意識した設計が重要なのか
  4. 保守担当者が困るシステムの特徴
  5. 保守担当者が困らない設計の基本
  6. 具体例1：設定値を変更しやすくする
  7. 具体例2：変更箇所を分かりやすくする
  8. 具体例3：障害調査に必要なログを残す
  9. 具体例4：エラー原因を判断できるようにする
  10. 具体例5：バックアップだけでなく切り戻しを考える
  11. 具体例6：手順書を残して属人化を防ぐ
  12. 正常な状態を定義しておく
  13. GUIだけに依存しない確認方法を用意する
  14. Windows環境ではイベントビューアーも確認する
  15. 保守担当者が行う原因切り分け
  16. ユーザー側・ネットワーク側・サーバー側を切り分ける
  17. 変更による影響範囲を分かるようにする
  18. 保守時には「直前の変更」を確認する
  19. 筆者が現場で困った保守しにくいシステムの例
  20. 保守担当者が困らない設計で初心者がやりがちなミス
  21. 現場で評価される保守の確認手順
  22. 上司へ報告するときのポイント
  23. エスカレーションするタイミング
  24. 本番環境の設定変更で注意すること
  25. 新人が覚えておきたい保守しやすい設計の6つのポイント
  26. 関連して覚えておきたいIT用語
  27. 保守担当者が困らない設計についてよくある質問
    1. Q．保守性が高いとはどういう意味ですか？
    2. Q．ログを残していれば保守しやすくなりますか？
    3. Q．手順書は開発担当者が作るべきですか？
    4. Q．障害時は最初に何を確認すればよいですか？
    5. Q．設定変更前に最も重要なことは何ですか？
    6. Q．保守担当者の意見は設計段階から聞いた方がよいですか？
  28. まとめ

保守担当者が困らない設計とは

保守担当者が困らない設計とは、システム稼働後の修正や変更、障害対応を安全かつ効率的に行えるようにする設計です。

例えば、ある社内システムでエラーが発生したとします。

ソースコードのどこでエラーになったか分からず、ログにも「エラーが発生しました」としか残っていなければ、保守担当者は原因調査に多くの時間を使います。

一方、発生日時、エラーコード、処理内容、対象機能、関連する処理IDなどがログに残っていれば、原因を絞り込みやすくなります。

保守性とは、問題が起きたときに「調べやすい・直しやすい・戻しやすい」ことだと考えると分かりやすいでしょう。

運用と保守の違い

IT初心者が混乱しやすいのが「運用」と「保守」の違いです。

項目 主な内容
運用 システムを日常的に安定稼働させるための監視や定常作業
保守 障害修正、設定変更、機能修正、更新対応などを行う作業

例えば、サーバーが正常に動いているか毎日確認するのは運用、障害原因を調査して設定やプログラムを修正するのは保守に近い作業です。

ただし、実際の現場では運用担当者と保守担当者を明確に分けていないケースもあります。

社内SEや情シスでは、一人の担当者が運用と保守の両方を担当することも珍しくありません。

なぜ保守担当者を意識した設計が重要なのか

システムは稼働後に必ず何らかの変更が発生します。

このとき、設計が複雑で変更影響を把握できないと、小さな修正でも大きな障害につながる可能性があります。

保守を考えた設計にしておけば、変更時の確認範囲が分かりやすくなり、障害復旧も早くなります。

保守担当者が困るシステムの特徴

困る設計 保守現場で起こること
仕様書がない 現在の正しい動作が分からない
設定値がソースコード内に埋め込まれている 設定変更だけでもプログラム修正が必要になる
ログが少ない 障害原因を追跡できない
ログが多すぎる 必要な情報を探しにくい
処理が複雑に結合している 1か所の変更が別機能へ影響する
変更履歴が残らない いつ誰が何を変更したか分からない
復旧手順がない 障害時に作業担当者の判断へ依存する
特定担当者しか分からない 異動や退職後に対応できない

保守担当者が困らない設計の基本

保守しやすいシステムを考えるときは、次の順番で確認すると整理しやすくなります。

  1. 現在の状態を確認できるか
  2. 異常が起きた原因を調査できるか
  3. 変更箇所を特定できるか
  4. 変更による影響範囲を把握できるか
  5. 変更前の状態へ戻せるか
  6. 別の担当者でも作業できるか

この6点がそろっていると、保守担当者の負担を大きく減らせます。

具体例1：設定値を変更しやすくする

保守時によく発生するのが設定変更です。

例えば、システムが接続するサーバー名やメール送信先、タイムアウト値などは将来変更される可能性があります。

こうした値がプログラムの中へ直接書き込まれていると、設定を一つ変更するだけでもソースコードの修正、テスト、リリースが必要になります。

変更頻度が高い項目については、設定ファイルや管理画面などから変更できるようにする方法があります。

ただし、簡単に変更できればよいというものではありません。

誰が変更できるのか、変更履歴が残るのか、変更ミスを戻せるのかも合わせて設計します。

具体例2：変更箇所を分かりやすくする

保守しやすい設計では、1つの機能を修正したときに、関係のない機能まで影響しにくくすることが重要です。

例えば、メール送信処理を複数の機能がそれぞれ独自に持っている場合、メールサーバーの仕様が変わると複数箇所を修正する必要があります。

共通処理として整理されていれば、変更箇所を減らせる可能性があります。

このようにシステムの機能を適切に分割し、役割を分けることで保守性を高められます。

具体例3：障害調査に必要なログを残す

保守担当者にとってログは非常に重要です。

例えば利用者から「昨日の15時頃に登録処理が失敗した」と連絡があった場合、ログからその時間帯の処理を確認します。

必要に応じて次のような情報を記録します。

一方で、パスワードや認証情報などの機密情報をログへ出力してはいけません。

ログの保存場所、保存期間、閲覧権限、容量についても設計段階で決めておきます。

具体例4：エラー原因を判断できるようにする

すべてのエラーが同じメッセージでは、保守担当者が原因を切り分けられません。

例えば「ログインできない」という事象でも、原因には複数の候補があります。

保守担当者がこれらを切り分けられるように、エラーコードやログ、監視情報などを準備しておくことが大切です。

具体例5：バックアップだけでなく切り戻しを考える

保守作業では、変更後に問題が発生することがあります。

そのため、変更前に「失敗したらどう戻すのか」を決めておく必要があります。

例えば設定ファイルを修正するなら、変更前のファイルを保存しておきます。

データベースを変更する場合は、バックアップや復元手順を確認します。

アプリケーションを更新するなら、旧バージョンへ戻せるかも確認します。

変更手順と切り戻し手順はセットで考えることが保守現場では重要です。

具体例6：手順書を残して属人化を防ぐ

保守担当者が困る代表的なケースが、「前任者しか分からない」です。

システムの設定方法や再起動方法を一人しか知らない状態を属人化と呼びます。

属人化を減らすため、最低限次のような資料を残します。

重要なのは、資料が存在するだけではありません。

古い情報のまま放置せず、変更に合わせて更新する必要があります。

正常な状態を定義しておく

保守担当者が障害対応するとき、「現在の状態が正常なのか異常なのか」を判断できなければなりません。

例えばWindowsサービスなら、サービスが起動しているだけではシステム全体が正常とは限りません。

次のような正常性確認を決めておくと判断しやすくなります。

「正常時はどのような状態なのか」を記録しておくことが、障害時の比較材料になります。

GUIだけに依存しない確認方法を用意する

GUI（Graphical User Interface）は、画面上のボタンやメニューを使う操作方法です。

一方、CUI（Character User Interface）は、コマンドプロンプトやPowerShellでコマンドを入力して操作します。

保守担当者は障害内容によってGUIとCUIを使い分けます。

確認内容 コマンド例
IPアドレス確認 ipconfig /all
通信確認 ping
DNS確認 nslookup
ログインユーザー確認 whoami
Windowsサービス確認 Get-Service
ネットワーク設定確認 Get-NetIPConfiguration

コマンドで確認できるようにしておくと、画面操作ができない状況でも調査できる場合があります。

Windows環境ではイベントビューアーも確認する

Windows 11やWindows Serverで問題が発生した場合、イベントビューアーが原因調査に役立つことがあります。

  1. 「Windowsキー + R」を押します。
  2. 「eventvwr.msc」と入力します。
  3. Enterキーを押します。
  4. 「Windowsログ」を開きます。
  5. 「システム」または「アプリケーション」を確認します。
  6. 障害発生時刻付近のイベントを確認します。

主に発生日時、イベントID、ソース、イベントレベル、メッセージを確認します。

ただし、イベントビューアーにエラーが記録されているからといって、それが障害原因とは限りません。

利用者から申告された発生時刻や現象と一致しているかを確認してから判断します。

保守担当者が行う原因切り分け

例えば「社内システムにログインできない」という障害が発生した場合、原因を一つずつ切り分けます。

  1. 1人だけか複数人で発生しているか確認する
  2. 特定PCだけか確認する
  3. 別のユーザーでも発生するか確認する
  4. ネットワークへ接続できているか確認する
  5. DNSによる名前解決を確認する
  6. 対象サーバーへ通信できるか確認する
  7. Windowsサービスやアプリケーションを確認する
  8. Active Directory側のアカウント状態を確認する
  9. 権限を確認する
  10. ログを確認する
  11. 直前の変更作業を確認する

この切り分けに必要な情報が取得できるようにしておくことも、保守担当者を意識した設計です。

ユーザー側・ネットワーク側・サーバー側を切り分ける

確認対象 確認するポイント
ユーザー側 操作、ログインユーザー、パスワード、権限
Windows側 OS、サービス、端末設定、イベントログ
ネットワーク側 IPアドレス、通信経路、ファイアウォール
DNS側 名前解決、DNSレコード
DHCP側 IPアドレスが正常に割り当てられているか
Active Directory側 アカウント、認証、グループ、権限
サーバー側 サービス、CPU、メモリ、ディスク、ログ
アプリケーション側 プログラムエラー、設定、外部システム接続

変更による影響範囲を分かるようにする

保守作業で重要なのが影響範囲です。

例えばDNSサーバーの設定を変更すると、そのDNSを利用している複数のPCやサーバーへ影響する可能性があります。

Active Directoryのグループポリシーを変更すれば、多数のユーザーやWindows端末へ設定が適用されることもあります。

そのため、設計書や構成図で「この設定はどの機器やシステムから利用されているか」を把握できるようにします。

変更対象だけを見るのではなく、その設定を利用している周辺システムまで確認する習慣が重要です。

保守時には「直前の変更」を確認する

障害対応で非常に重要なのが、障害発生前に何か変更されていないか確認することです。

障害発生日時と変更日時が近い場合、その変更が原因である可能性を調査します。

このため、変更管理表や作業履歴を残す仕組みが保守では役立ちます。

筆者が現場で困った保守しにくいシステムの例

私自身、過去に設定値の保存場所が分からず、変更箇所を探すだけで時間を使った経験があります。

設計資料には古い設定が記載されており、現在の環境と一致していませんでした。

さらに、どの設定を変更すると何に影響するのかも十分に記録されていなかったため、すぐには変更できませんでした。

この経験から、保守では高度な技術だけではなく、「正しい情報が整理され、誰でも確認できる状態」そのものが重要だと感じました。

それ以降は、設定変更を行った場合に手順書や構成資料も更新することを意識しています。

保守担当者が困らない設計で初心者がやりがちなミス

現場で評価される保守の確認手順

新人のうちは、すぐに設定変更するのではなく、確認を積み重ねることが大切です。

  1. 発生している事象を整理する
  2. 影響範囲を確認する
  3. 発生日時を確認する
  4. 直前の変更内容を確認する
  5. 正常な箇所と異常な箇所を分ける
  6. ログを確認する
  7. 原因候補を絞り込む
  8. 変更前にバックアップや現在値を保存する
  9. 切り戻し方法を確認する
  10. 承認を得てから変更する
  11. 変更後に正常性を確認する
  12. 作業内容を記録する

「変更する前に、元へ戻せる状態を作る」ことは新人が特に覚えておきたいポイントです。

上司へ報告するときのポイント

保守作業中に問題が発生した場合、「直りません」とだけ報告しても状況は伝わりません。

最低限、次の情報を整理します。

例えば「10時20分頃から営業部の5名が共有フォルダへ接続できません。別部署では利用可能です。サーバーへのpingは正常で、営業部ユーザーのアクセス権限を確認しています」のように伝えると、上位担当者も状況を判断しやすくなります。

エスカレーションするタイミング

保守担当者が自分だけで長時間調査を続けると、障害の影響が拡大することがあります。

次のような場合は、社内ルールに従って早めにエスカレーションします。

本番環境の設定変更で注意すること

保守担当者は本番環境を直接変更する機会があります。

特に、Active Directory、グループポリシー、DNS、DHCP、ファイアウォール、アクセス権限、データベースなどの設定変更は影響範囲が大きくなる可能性があります。

作業前には必ず次の内容を確認します。

原因が分からない状態で「とりあえず設定を変えてみる」という対応は避けてください。

新人が覚えておきたい保守しやすい設計の6つのポイント

  1. 分かる：現在の構成や設定を確認できる
  2. 追える：ログや変更履歴から原因を追跡できる
  3. 直せる：修正すべき場所を特定しやすい
  4. 影響が読める：変更による影響範囲を把握できる
  5. 戻せる：失敗しても変更前へ切り戻せる
  6. 引き継げる：担当者が変わっても対応できる

この6つを意識すると、システム開発の経験が少なくても「保守担当者が何に困るのか」を考えやすくなります。

関連して覚えておきたいIT用語

用語 初心者向けの意味
保守性 システムを修正・変更しやすい性質
ログ システムで発生した処理やエラーの記録
バックアップ 障害に備えてデータを別に保存すること
リストア バックアップからデータを復元すること
切り戻し 変更後に問題が発生した場合、変更前へ戻すこと
変更管理 誰がいつ何を変更したか管理すること
構成管理 サーバーやソフトウェア、設定情報などの構成を管理すること
属人化 特定の担当者しか作業方法を知らない状態
エスカレーション 問題を上位担当者や専門部署へ引き継ぐこと

保守担当者が困らない設計についてよくある質問

Q．保守性が高いとはどういう意味ですか？

障害原因を調査しやすく、修正箇所が分かりやすく、安全に変更できる状態を指します。担当者が変わっても対応できることも重要です。

Q．ログを残していれば保守しやすくなりますか？

ログは重要ですが、それだけではありません。設計書、変更履歴、復旧手順、設定管理なども必要です。

Q．手順書は開発担当者が作るべきですか？

役割分担は現場によって異なりますが、開発担当者と保守担当者が協力して作成するのが理想的です。実際に保守する人が読んで作業できる内容になっているか確認します。

Q．障害時は最初に何を確認すればよいですか？

まず影響範囲と発生日時を確認します。その後、直前の変更、ユーザー側、端末側、ネットワーク側、サーバー側、アプリケーション側と順番に切り分けます。

Q．設定変更前に最も重要なことは何ですか？

影響範囲と切り戻し方法を確認することです。現在値やバックアップを保存し、問題が発生しても元へ戻せる状態で作業します。

Q．保守担当者の意見は設計段階から聞いた方がよいですか？

はい。障害対応や変更作業を実際に経験している保守担当者は、開発担当者だけでは気付きにくい問題を知っていることがあります。設計段階から保守側の意見を取り入れることで、稼働後のトラブルを減らしやすくなります。

まとめ

保守担当者が困らない設計とは、単にプログラムを修正しやすくすることではありません。

障害時に原因を調査できること、変更の影響範囲が分かること、安全に修正できること、問題があれば元へ戻せること、そして別の担当者へ引き継げることが重要です。

IT初心者のうちは、システムが正常に動くかどうかだけに注目しがちです。しかし実際の現場では、障害や設定変更が発生したときの対応しやすさがシステムの品質を大きく左右します。

設計するときは「このシステムで3年後に障害が起き、自分とは別の担当者が対応するとしたら、必要な情報がそろっているか」と考えてみてください。

「分かる・追える・直せる・影響が読める・戻せる・引き継げる」という視点を持つことが、保守担当者が困らない設計への第一歩です。

モバイルバージョンを終了