ドキュメントセンター

Project A

EasyOps ドキュメント

Knowledge Base

フルスタックの運用および保守のナレッジベース

キーポイント:は、オフライン検索と分類された閲覧をサポートし、ネットワークのないコンピューター室のシナリオに適応します。

ネットワークエンジニアリング

Huawei/H3C/Cisco コマンドのクイックチェック、OSPF/STP のトラブルシューティング。

弱電流セキュリティ

IPC デバッグ、アクセス制御配線図、黒い画面と PTZ 障害位置の監視。

デスクトップの運用と保守

Windows のトラブルシューティング、プリンター共有の問題、DNS/IP の修復。

Linux/サーバー

シェル共通コマンド、RAID メンテナンス、ファイアウォール設定および強化。

クラウドネイティブ

Docker/K8s 共通コマンド、Pod 例外診断およびデプロイメントのクイックチェック。

データベース

MySQL / Redis の運用およびメンテナンスマニュアル、スロークエリ、バックアップおよびリカバリガイド。

Toolbox

エンジニアリングツールボックス

キーポイント:のオンサイト高周波機能は、「計算 + 診断 + クエリ + 運用保守」に従って階層的に構成されており、ツールの迅速な配置を容易にします。

セキュリティストレージ

NVR ハードドライブ容量の見積もり

サブネットマスク

IP 範囲とブロードキャストコンピューティング

PoE 消費電力

端末電源予算

ファイバーの減衰

リンク dB 損失の推定

ネットワーク診断

TCP Ping / ポートスキャン / LAN スキャン

ネットワーク運用保守センター

HTTP 検出/WOL/ツール集約

ネットワーククエリセンター

DNS / Whois(RDAP) / OUI

SSHツール

接続管理/ステータスポーリング/クイックコマンド

最初の初期化命令

キーポイント:は、約 15MB のコアデータをダウンロードするために初めてインターネットに接続する必要があります。初期化完了後はオフラインでも使用可能です。

ローカル優先度:ナレッジベース、コレクション、履歴、スキャン結果は、デフォルトでデバイスのローカルに保存され、コアデータはアップロードされません。

安全なストレージ:機密の構成アイテムは、クリアテキストの公開を避けるために、システムセキュリティ機能 (キーチェーンなど) を使用して保存されます。

Project Divider

Project B

Asset Sonar ドキュメント

導入と構成

実稼働構成に切り替える前に、テスト環境で完全なプロセスのドリル (スキャン→検証→同期→エクスポート) を完了することをお勧めします。

重要なお知らせ

本番環境に入る前に、テスト環境を完全に完了することをお勧めします。制作の最初のバッチでは、10 ～ 20 のグレースケール単位を同期し、安定化後にボリュームを解放することをお勧めします。

01環境要件

Windows 10/11 (22H2+ 推奨、x64)
.NET Desktop Runtime 8.0 (x64)
管理者権限で実行することをお勧めします (完全なハードウェアおよびシステム情報を読みやすくするため)
Snipe-IT API キー (少なくともアセットの読み取りと書き込み、コンポーネント/アクセサリの関連付け権限を持つ)
クライアントは Snipe-IT ネットワークからアクセス可能です (HTTP/HTTPS およびリバースプロキシポリシーによって許可されています)

02profiles.json の例 (複数の環境)

{
  "Profiles": [
    {
      "Name": "Production",
      "ApiUrl": "http://snipeit.company.local/api/v1",
      "ApiKey": "YOUR_PROD_API_KEY",
      "TagPrefix": "AS-",
      "EnableComponents": true,
      "EnableAccessories": true,
      "Location": "HQ",
      "Company": "JianXiu Tech"
    },
    {
      "Name": "Lab",
      "ApiUrl": "http://snipeit-lab.local/api/v1",
      "ApiKey": "YOUR_LAB_API_KEY",
      "TagPrefix": "LAB-",
      "EnableComponents": false,
      "EnableAccessories": false,
      "Location": "LAB",
      "Company": "JianXiu Tech"
    }
  ]
}

API キーは、安全に保管するためにシステムセキュリティメカニズムに引き渡し、共有マシンに平文で長期間保存しないことをお勧めします。

02.1アクセサリ/コンポーネント/モデル構成リファレンス

は、Snipe-IT の「コンポーネント、アクセサリ、およびモデル」のマッピングの名前を統一し、同期中の関連付けの失敗や重複の作成を回避するために使用されます。

{
  "ActiveProfile": "默认",
  "Profiles": {
    "默认": {
      "InternalUrl": null,
      "ExternalUrl": null,
      "ApiKey": null,
      "Department": null,
      "AssignName": null,
      "AssignUser": null,
      "AssignPassword": null,
      "EmailSuffix": "example.com",
      "ASSET_TAG_PREFIX": "DOZ",
      "CATEGORY_ID_MAP": {
        "笔记本电脑": 4,
        "台式机": 3,
        "显示器": 5
      },
      "COMPONENT_CATEGORY_ID_MAP": {
        "处理器": 7,
        "内存": 9,
        "硬盘": 10
      },
      "ACCESSORY_CATEGORY_ID_MAP": {
        "键盘": 15,
        "鼠标": 16
      },
      "CATEGORY_CODE_MAP": {
        "笔记本电脑": "BJB",
        "台式机": "TSJ"
      }
    }
  }
}

最初に Snipe-IT でターゲットを事前にビルドすることをお勧めします Model、Component、Accessory、バッチ同期を再度実行してください。
同義語によってオブジェクトが重複するのを避けるために、名前付けは一意で安定したものに保つ必要があります (例: 16G / 16GB）。
を初めて起動する場合は、バッチを拡張する前に 10 ユニットをサンプリングしてマッピングを確認することをお勧めします。

03推奨操作手順（本番環境）

準備段階 (オンラインになる前)
- 現在選択されている内容を確認します Production テスト環境の誤記述を避けるためのプロファイル。
- 検証 ApiUrl、ApiKey、コンポーネント/アクセサリスイッチはこのインベントリの範囲と一致します。
- まず、プロトタイプマシンを使用して接続を検証します (キーフィールドのスキャン、同期、および書き戻しが可能)。
スキャンステージ (最初はローカル、次に同期)
- は、シリアル番号、モデル番号、資産タグが完全であるかどうかのチェックに重点を置いて、ローカルスキャンを実行します。
- ダーティデータがアセットライブラリに直接同期されるのを避けるために、最初に null 値フィールドに入力するかマークを付けてください。
- 部門/フロアに応じてタスクをバッチで構築することをお勧めします (たとえば、バッチごとに 30 ～ 50 単位)。
検証段階（サンプリング検証）
- バッチごとに 3 ～ 5 ユニットをサンプリングし、資産タグ、シリアル番号、モデル、および場所フィールドのマッピングを確認します。
- 「資産の更新が存在します/新しい資産が存在しません」の動作が期待どおりであることを確認します。
- フィールドの不整合が見つかった場合は、後続のバッチを続行する前にマッピング構成を修正してください。
同期段階（階調高度化）
- は、最初に小さなバッチで同期し (最初のバッチには 10 ～ 20 ユニットが推奨されます)、エラーコードと失敗率を観察します。
- 1 回限りの完全インポートによって引き起こされるロールバック圧力を避けるために、バッチが安定していることを確認してからバッチを拡張します。
- 各バッチが完了した直後にスナップショット (CSV/PDF) をエクスポートし、バッチ番号を記録します。
例外処理ステージ (ストップロスが最初)
- 大規模な障害が発生した場合、後続のバッチは一時停止され、完全な再実行は実行されません。
- は、エラーコードグループ (401/403 パーミッション、404 パス、409 競合、422 フィールド) に従って処理されます。
- が修復された後は、失敗したオブジェクトのみが再試行され、成功したオブジェクトは繰り返し書き込まれません。
終了段階 (アーカイブとレビュー)
- は、「スキャンスナップショット + 同期結果 + 例外リスト + 操作ログ」をアーカイブします。
- は、この設定変更と問題処理の結論を記録し、チーム SOP を更新します。

04フィルタリングとノイズ除去の提案

"IGNORE_KEYWORDS": [
  "VMware", "Virtual", "Hyper-V", "Loopback", "Bluetooth",
  "WAN Miniport", "Teredo", "Docker", "vEthernet"
]

は、仮想ネットワークカード、トンネルアダプター、および一時インターフェイスをフィルター処理して、無効な資産ノイズを低減するために使用されます。

05エクスポートとアーカイブの提案

システムの調整と手動署名の保持を容易にするために、インベントリ段階で CSV + PDF を同時にエクスポートすることをお勧めします。
の命名案:site-dept-date-batch、たとえば hq-it-2026-04-08-b01。
監査レビューを容易にするために、「スキャンスナップショット + 同期結果 + 例外リスト」を同じアーカイブディレクトリに配置します。

よくある質問とトラブルシューティング

問題をすぐに特定するために、最初に「現象→原因→対処手順」を読み、トラブルシューティングを行うことをお勧めします。

1) シリアル番号をスキャンできないか、モデル番号が空ですか?

一般的な理由: 権限が不十分、WMI サービスが異常、デバイス BIOS 情報が欠落しています。

Asset Sonar を管理者として実行します。
WMI サービス (Winmgmt) が正常か確認してください。
BIOS/UEFI でシリアル番号フィールドがクリアされていないことを確認します。

2) Snipe-IT (401/403/404) に接続できませんか?

まず、API アドレスに次の内容が含まれていることを確認します。 /api/v1、キーと権限を再度確認してください。

401: API キーが間違っているか、有効期限が切れています。
403: キー権限が不十分です (書き込み/関連付け権限がありません)。
404: パスエラー。リバースプロキシは API ルートを転送しません。

3) 同期後に重複したアセットが表示されますか?

の重複は通常、「シリアル番号の不一致」または「過去のダーティデータ」が原因で発生します。

は、主キー戦略として「シリアル番号 + 資産タグ」を優先します。
過去の空のシリアル番号資産を手動で入力するか、アーカイブ用にマークを付けます。
まず、本番環境で起動する前に、テスト環境でバッチを実行して複製戦略を確認します。

4) コンポーネント/アクセサリの関連付けに失敗しましたか?

は、ターゲットオブジェクトが存在しない場合、または ID マッピングが失敗した場合によく発生します。

対象のコンポーネント、アクセサリがSnipe-ITに存在し、割り当て可能であることを確認してください。
プロファイルで有効になっているかどうかを確認してください EnableComponents / EnableAccessories。
失敗ログのオブジェクト名と ID を確認し、マッピングを修正して再試行してください。

5) スキャン速度が遅い、または UI が固まっていますか?

では、同時実行性を減らし、スキャン範囲を狭め、仮想デバイスをフィルタリングすることを推奨しています。

まずハードウェアメインフィールド収集を実行し、次に拡張フィールド補助スキャンを実行します。
ノイズを軽減するために、仮想ネットワークカードと無効なインターフェイスを除外します。
大量の一括棚卸をバッチで実行します(部門/フロアごと)。

6) エクスポートされたファイルは文字化けしていたり、フィールドの位置がずれていませんか?

は通常、エンコードまたは地域設定の違いが原因で発生します。

CSVインポートテーブルツールはUTF-8(BOM含む)の使用を推奨します。
ローカライズの違いを避けるために、日付形式と小数点の規則を統一します。
チーム間で転送する場合は、変形を防ぐためPDFアーカイブ版の使用を優先してください。

7) 「部分的な成功と部分的な失敗」はなぜ起こるのでしょうか?

これはバッチ処理シナリオにおける通常の保護戦略です。成功した項目は最初にライブラリにドロップされ、失敗した項目は再試行キューに入れられます。

まず障害リストをエクスポートし、エラーコードに従ってグループに分けて処理します。
権限/マッピング/ネットワークを修正した後、失敗したバッチを再試行してください。
は完全な再実行を回避し、繰り返しの書き込みやダーティデータのリスクを軽減します。

8) 本番環境で安全にオンラインに接続するにはどうすればよいですか?

では、「グレースケールオンライン」方法を推奨しています。

ラボプロファイルで最初のテストを実行し、フィールドマッピングを確認します。
運用環境は、最初に同期の最初のバッチとして狭い範囲のアセットを選択します。
異常がないことを確認後、範囲を拡張し、バッチごとのエクスポートスナップショットを保持します。

エラーコードのクイックチェック (HTTP/一般的なエラー)

は、「構成の問題、権限の問題、ネットワークの問題」をどこから始めるべきかを迅速に判断するために使用されます。

エラーコード/現象	一般的な理由	優先処理ステップ
`401 Unauthorized`	API キーが間違っているか、有効期限が切れているか、取り消されています	キーを再生成し、リクエストヘッダーの形式とプロファイルが有効であることを確認します
`403 Forbidden`	キー権限が不十分です (書き込み/関連付けがありません)	アセット、コンポーネント、アクセサリ関連の権限をキーに追加します
`404 Not Found`	URL パスエラー、欠落しています `/api/v1`	ApiUrl を修正し、リバースプロキシ転送ルールを確認する
`409 Conflict`	資産タグまたはシリアル番号の競合	主キーを押して最初に重複を削除し、次に増分同期を実行します。
`422 Unprocessable Entity`	フィールド形式が API 要件を満たしていません	必須フィールド、長さ、列挙値、日付形式を確認してください
`429 Too Many Requests`	リクエスト頻度が高すぎると電流制限がトリガーされます	同時実行性を減らし、バックオフの再試行とバッチ間隔を増やす
`500 / 503`	サーバー例外またはメンテナンス期間	失敗したバッチを保持し、一定の間隔で再試行し、サーバー管理者に連絡してください
接続タイムアウト/TLS エラー	ネットワークに到達できず、証明書チェーンが異常です。	最初に接続をテストし、次に証明書と時刻の同期を確認します

トラブルシューティングランブック（オンサイト実行版）

同期異常時は、誤判断や繰り返し操作を減らすために、以下の順序で実行することを推奨します。

フェーズ A: 基本的な接続

ApiUrl にアクセスできるかどうかを確認します (含む) /api/v1）。
DNS 解決、ポートポリシー、およびプロキシルールを検証します。
TLS 検証の失敗を避けるために、デバイスのシステム時間が正確であることを確認してください。

フェーズ B: 権限と構成

API キーの有効性とロールの権限を確認してください。
[プロファイル] で正しい環境 (Lab/Prod) が選択されていることを確認します。
コンポーネント/アクセサリのスイッチがマッピングと一致しているかどうかを確認してください。

フェーズ C: データ品質と重複排除

サンプルベースでシリアル番号、資産タグ、およびモデルフィールドを確認します。
過去の空のシリアル番号と重複した資産をクリーンアップします。
失敗したバッチの「エラーコード → ハンドラー」追跡テーブルを作成します。

フェーズ D: 回復と再生

完全な再実行を避けるために、失敗したバッチのみを再試行します。
「成功/失敗リスト」をエクスポートしてアーカイブします。
根本原因と修復計画を記録し、チーム SOP を更新します。

5 分間のクイックトラブルシューティングカード (緊急対応)

は、「現場が緊急であり、最初に復元してからさらに深く掘り下げる」シナリオに適しています。まず問題を優先順位付けしてから、完全なランブックを入力します。

1分目

エラーコードを参照

まず 4xx / 5xx / タイムアウトを区別し、パーミッション回線を使用するかネットワーク回線を使用するかを決定します。

2分目

URL とキーの検証

確認 /api/v1、プロファイル、API キー、権限は正しいですか?

3～4分

小規模バッチの再試行

は、影響の拡大を避けるために、失敗したオブジェクトのみを再試行し、完全な再実行は行いません。

5分目

証拠を残す

作業指示書のテンプレートに従って、障害リストとログのフラグメントをエクスポートし、レポートして引き継ぎます。

ドキュメント センター.