Hướng dẫn sử dụng NetScope Console Using NetScope Console

Tài liệu này dành cho người dùng cuối. Mỗi phần đi theo đúng trình tự các trang trong giao diện — từ lúc bạn đăng nhập cho tới khi cấu hình cảnh báo hay phát API key. Không cần kiến thức về server hay dòng lệnh. This guide is written for end users. Each section follows the order of the pages in the UI — from the moment you sign in to configuring alerts or issuing API keys. No server or command-line knowledge required.

1 · Đăng nhập 1 · Signing in

Mở trình duyệt và truy cập vào đường dẫn NetScope Console mà quản trị viên đã cung cấp cho bạn. Màn hình đầu tiên là biểu mẫu đăng nhập. Open your browser and visit the NetScope Console URL your administrator sent you. The first screen is the sign-in form.

1. Nhập tên đăng nhập và mật khẩuEnter your credentials

   Dùng thông tin tài khoản do quản trị viên cấp. Nếu bạn chưa có tài khoản, liên hệ quản trị viên nội bộ để được tạo. Use the credentials provided by your administrator. If you don't have an account yet, contact them to have one created.

2. Phiên đăng nhậpYour session

   Sau khi đăng nhập thành công, phiên làm việc kéo dài trong một ngày làm việc. Khi hết hạn, bạn chỉ cần đăng nhập lại — dashboard sẽ mở đúng layout cũ. Once signed in, your session lasts through the work day. When it expires, just sign in again — your dashboard layout is preserved.

3. Đổi mật khẩuChange your password

   Chọn avatar ở góc phải trên → Đổi mật khẩu. Nhập mật khẩu hiện tại và mật khẩu mới (tối thiểu 12 ký tự, nên có cả chữ và số). Click your avatar in the top-right corner → Change password. Enter the current one and pick a new one (12+ characters, mix of letters and numbers recommended).

2 · Khái niệm cốt lõi 2 · Core concepts

Trước khi đi vào từng trang, hãy làm quen với một số từ bạn sẽ thấy liên tục trong giao diện. Before touring the pages, here are a few terms that show up everywhere in the UI.

3 · Dashboard 3 · Dashboard

Đây là trang chủ của NetScope. Bạn sẽ thấy biểu đồ lưu lượng tổng, các bảng top talker và top ASN. Mọi widget đều tự cập nhật — không cần F5. This is NetScope's home page. You'll see the overall traffic chart, top talker tables, and top ASN lists. Every widget refreshes itself — no reload needed.

Các widget bạn sẽ thấyWidgets you'll see

Tùy chỉnh layoutCustomize the layout

• Kéo-thả: nắm vào phần tiêu đề widget để kéo đến vị trí khác.Drag: grab a widget's title bar to move it.
• Thay đổi kích thước: kéo góc phải dưới của widget.Resize: drag the bottom-right corner of a widget.
• Ẩn widget: dấu × trên góc phải của widget.Hide: click the × in the top-right.
• Thêm lại: nút + Widget ở đầu trang mở ra danh sách widget có thể thêm.Add back: the + Widget button at the top opens the list of available widgets.

Bố cục của bạn tự động được lưu lại trên chính trình duyệt này — mỗi người có bố cục riêng.Your layout is saved automatically in this browser — each person has their own.

4 · Quản lý Sensor 4 · Managing sensors

Mỗi sensor đại diện cho một thiết bị (router / switch) đang gửi flow về. Ở trang Sensors, bạn xem danh sách, thêm mới, chỉnh sửa hoặc xóa sensor. Thao tác có hiệu lực ngay lập tức — không cần khởi động lại gì. Each sensor represents one device (router / switch) sending flows. On the Sensors page you can list, add, edit, or remove sensors. Changes take effect immediately — nothing to restart.

Ý nghĩa các trườngWhat each field does

Các bước thêm một sensor mớiAdding a new sensor

1. Nhờ người quản trị router bật flow exportAsk the router admin to enable flow export

   Họ cần cấu hình router trỏ flow về địa chỉ NetScope Console của bạn, đúng cổng được chọn ở bước sau. Nên dùng tốc độ mẫu (sampling rate) 1:1024 hoặc 1:4096 — cao hơn sẽ mất chi tiết, thấp hơn sẽ nặng cho cả hai bên.They need to point their router to the NetScope Console address and the port you're about to choose. A sampling rate of 1:1024 or 1:4096 is a good default — higher loses detail, lower burdens both sides.

2. Nhấn "+ Sensor" trong trang SensorsClick "+ Sensor" on the Sensors page

   Điền tên mô tả, chọn đúng giao thức, nhập IP của router. Kiểm tra lại cổng đã khớp với bên router chưa.Fill in the descriptive name, pick the right protocol, enter the router's IP. Double-check the port matches what the router is sending to.

3. Gán zoneAttach a zone

   Nếu chưa có zone phù hợp, hãy tạo ở mục IP Zones trước. Zone là yếu tố quyết định IP nào sẽ lên biểu đồ.If no suitable zone exists, create one in IP Zones first. Zones decide which IPs end up on charts.

4. Nhấn Lưu và kiểm tra ngaySave and verify

   Trong vòng vài giây, mở chi tiết sensor — ô Packets received phải tăng dần. Nếu không thấy, xem mục Khắc phục sự cố.Within seconds, open the sensor detail — the Packets received counter should climb. If not, see Troubleshooting.

5 · IP Zones 5 · IP Zones

Zone là cách bạn "khoanh vùng" những dải IP mình quan tâm. Không có zone nghĩa là hệ thống không biết dải nào là của bạn — các biểu đồ theo IP sẽ trống. Zones are how you carve out the IP ranges you care about. Without zones, the system has no idea which address space is yours — per-IP charts stay empty.

Cấu trúc câyTree structure

Một zone chứa nhiều node. Mỗi node là một dải CIDR, có thể lồng vào nhau theo cây:A zone holds multiple nodes. Each node is a CIDR range, and they can nest:

# Zone: Customer Network
203.0.113.0/24
  ├─ 203.0.113.0/26       # customer group A
  └─ 203.0.113.64/26      # customer group B
2001:db8::/32
  └─ 2001:db8:1::/48      # branch office

Khi hệ thống nhìn thấy một IP, nó chọn node cụ thể nhất chứa IP đó — bạn không cần chỉnh gì.When the system sees an IP, it picks the most specific node containing it — no manual mapping required.

Hai công tắc cho mỗi nodeTwo switches per node

• Hiện trên biểu đồShow on charts — bật thì IP trong node này sẽ có biểu đồ riêng. — when on, IPs in this node get their own chart.
• Tính vào tổngCount in totals — bật thì cộng vào số bps / pps tổng. — when on, contributes to total bps / pps.

Mặc định cả hai bật. Node con kế thừa từ node cha; bạn có thể bỏ chọn ở con để tắt riêng.Both on by default. Children inherit from parents; uncheck at the child level to override.

Thêm nhiều CIDR cùng lúcBulk add

Khi có danh sách dài (ví dụ xuất từ file Excel), dùng nút Import trong trang zone để dán toàn bộ — mỗi dòng một CIDR. Nhanh hơn rất nhiều so với thêm từng cái.For long lists (e.g. from a spreadsheet), use the Import button on the zone page to paste them all — one CIDR per line. Much faster than adding them one-by-one.

6 · Tra cứu IP 6 · Looking up an IP

Trang IP cho bạn tìm một địa chỉ IP hoặc dải subnet và xem lịch sử lưu lượng. Hỗ trợ đầy đủ IPv4 và IPv6. The IP page lets you search for a single IP or a subnet and inspect the traffic history. Both IPv4 and IPv6 work.

Ba chế độ xemThree view modes

1. Một IPSingle IP — bps / pps của đúng địa chỉ đó. — bps / pps for just that address.
2. CIDR — cộng dồn cả dải, ví dụ 203.0.113.0/24. — aggregated across a subnet, e.g. 203.0.113.0/24.
3. IP + giao thứcIP + protocol — phân tách theo TCP, UDP, DNS, HTTPS… — broken down by TCP, UDP, DNS, HTTPS…

Độ mịn biểu đồ theo khoảng thời gianChart resolution by range

Hệ thống tự chọn độ mịn hợp lý để vừa xem dài hạn vẫn mượt vừa không bỏ sót đỉnh ngắn:The system picks a sensible resolution so you can zoom out smoothly without missing short spikes:

7 · Xem flow trực tiếp 7 · Live flow view

Trang Flows hiển thị các flow mới nhất đang đi qua hệ thống, cập nhật liên tục. Hữu ích khi bạn đang điều tra sự cố, kiểm tra một router mới lắp, hoặc xác minh một rule cảnh báo. The Flows page shows the most recent flows streaming through the system, updating continuously. It's ideal for investigating incidents, verifying a newly installed router, or sanity-checking an alert rule.

LọcFilters

• Sensor — chỉ xem flow từ một thiết bị nhất định.Sensor — restrict to flows from one device.
• Giao thức — TCP / UDP / ICMP.Protocol — TCP / UDP / ICMP.
• IP hoặc CIDR — khớp với nguồn hoặc đích.IP or CIDR — match source or destination.
• Port — lọc theo cổng nguồn hoặc cổng đích.Port — filter by source or destination port.
• Tạm dừng — nút pause để xem kỹ một dòng mà không bị cuốn đi.Pause — stops the scroll so you can examine one row in peace.

8 · Cảnh báo 8 · Alerts

Cảnh báo gồm ba phần: Kênh (gửi thông báo đến đâu), Quy tắc (khi nào thì kích hoạt), và Lịch sử (đã gửi những gì). Alerts have three parts: Channels (where the notifications go), Rules (when they fire), and History (what's already been sent).

Tạo kênhCreate a channel

Nhấn Gửi thử sau khi tạo — một tin nhắn thử sẽ được gửi mà không ghi vào lịch sử. Đây là cách nhanh nhất để biết cấu hình có đúng không.Click Test after creating one — a test message is sent without being logged. The fastest way to confirm the setup.

Tạo quy tắcCreate a rule

1. Chọn phạm vi áp dụngChoose the scope

   Toàn hệ thống, một sensor, một dải CIDR hoặc một IP cụ thể.Whole system, one sensor, one CIDR, or one specific IP.

2. Chọn chỉ số & ngưỡngPick a metric and threshold

   Ví dụ: bps vào > 9 Gbps, hoặc pps ra > 500k. Đơn vị có thể chọn bằng dropdown cho tiện.E.g. inbound bps > 9 Gbps, or outbound pps > 500k. Units are selectable via dropdown for convenience.

3. Đặt thời gian duy trìSet the sustain time

   Điều kiện phải vượt ngưỡng liên tục trong bao nhiêu giây mới "nổ". 30–60 giây là giá trị điển hình để tránh cảnh báo do nhiễu ngắn.How many seconds the threshold has to be breached continuously before firing. 30–60 seconds is typical to avoid noise from short spikes.

4. Khoảng lặngCooldown

   Sau khi gửi cảnh báo, bao lâu sẽ im lặng dù điều kiện vẫn đúng. Mặc định 5 phút để tránh spam.How long to stay quiet after firing, even if the condition still holds. 5 minutes by default to avoid spam.

5. Gắn kênhAttach a channel

   Chọn Telegram / webhook đã tạo ở bước trên. Mỗi quy tắc có thể gắn một hoặc nhiều kênh.Pick the Telegram / webhook channel you created earlier. A rule can go to one or more channels.

6. Tùy chọn: thông báo khi hết sự cốOptional: notify on resolve

   Bật để nhận tin "OK" khi mọi thứ đã trở lại bình thường.Turn on to receive an "OK" message when things are back to normal.

Vòng đời của một cảnh báoThe life of an alert

Trạng thái chuyển theo:The state machine:

OK ──vượt ngưỡng──▶ Chờ ──đủ thời gian duy trì──▶ FIRING ──gửi cảnh báo
                                                          │
OK ◀──gửi thông báo "đã khắc phục"── xuống dưới ngưỡng đủ lâu ◀─┘

Xem lịch sửReview history

Tab Lịch sử liệt kê mọi tin đã gửi (hoặc gửi không thành công). Dùng để đối soát sau sự cố hoặc xác minh rằng Telegram bị treo không phải do cấu hình của mình.The History tab lists every notification, including failed deliveries. Use it for post-incident review or to confirm a Telegram outage isn't your own misconfiguration.

9 · Người dùng 9 · Users

NetScope có ba cấp quyền, phân cấp rõ ràng: NetScope has three hierarchical permission levels:

Tạo người dùngCreate a user

1. Vào trang Người dùng → nhấn + Người dùng mới.Open the Users page → click + New user.
2. Nhập tên đăng nhập (chỉ chữ thường, dấu chấm và gạch dưới) và mật khẩu tạm thời.Enter a username (lowercase, dots and underscores) and a temporary password.
3. Chọn quyền — có thể đổi lại sau.Pick a role — you can change it later.
4. Người dùng mới, lần đầu đăng nhập, sẽ được yêu cầu đổi mật khẩu.The new user is prompted to change their password on first sign-in.

10 · Cài đặt hệ thống 10 · System settings

Trang Cài đặt (chỉ admin) có hai khu vực liên quan tới người dùng: The Settings page (admin only) has two user-relevant areas:

API

• Giới hạn tốc độ — số yêu cầu / giây mà mỗi API key được phép. Mặc định 60 rps, cho phép vượt tạm thời tới 120 yêu cầu (burst).Rate limit — how many requests per second each API key is allowed. Default: 60 rps with bursts up to 120.
• Giữ lịch sử truy cập — số ngày lưu nhật ký API. Mặc định 30 ngày.Access history retention — how long to keep API logs. Default: 30 days.

GeoIP

Phần này quyết định các biểu đồ IXP / NIX hoạt động chính xác đến đâu.This section governs the accuracy of the IXP / NIX charts.

• Tải dữ liệu GeoIP — hoặc upload thủ công hai file dữ liệu (Country và ASN), hoặc nhập MaxMind license key để hệ thống tự cập nhật hàng tuần.Load GeoIP data — either upload the two data files (Country and ASN) manually, or paste in a MaxMind license key so the system refreshes weekly.
• Bật theo dõi IXP — tắt nếu bạn không quan tâm lưu lượng quốc tế; các widget IXP sẽ tự ẩn.Track IXP — turn off if you don't care about international traffic; IXP widgets auto-hide.
• Bật theo dõi NIX — tương tự với lưu lượng nội địa.Track NIX — same for domestic traffic.

11 · Thời gian lưu dữ liệu 11 · Data retention

Trang Retention (admin) cho phép đặt số ngày giữ dữ liệu theo từng mức chi tiết: The Retention page (admin) lets you set how many days to keep data at each level of detail:

12 · Cập nhật phiên bản 12 · Upgrades

Quản trị viên (Admin) có thể cập nhật NetScope ngay trong giao diện — không cần truy cập máy chủ. Admins can upgrade NetScope directly from the UI — no server access needed.

1. Kiểm tra phiên bản mớiCheck for updates

   Vào Cài đặt → Cập nhật → nút Kiểm tra. Hệ thống so sánh với kho phiên bản và hiển thị thay đổi.Open Settings → Updates → click Check. The system compares with the release channel and shows what's new.

2. Xem changelogReview the changelog

   Đọc những gì sẽ thay đổi trước khi áp dụng — đặc biệt những mục ghi chú "Breaking".Read what's changing before applying — pay extra attention to anything marked "Breaking".

3. Áp dụngApply

   Nhấn Cập nhật. Tiến độ hiển thị theo thời gian thực, từng bước. Dashboard gián đoạn khoảng một phút trong lúc cập nhật.Click Apply. Progress is shown live, step by step. The dashboard is unavailable for about a minute during the upgrade.

4. Tự phục hồi nếu lỗiAutomatic recovery on failure

   Nếu bất kỳ bước nào thất bại, hệ thống tự quay về phiên bản cũ. Bạn sẽ nhận thông báo trong UI — không mất dữ liệu.If any step fails, the system auto-reverts to the previous version. You'll see a notice in the UI — no data loss.

13 · API Keys 13 · API keys

API key dành cho hệ thống bên ngoài truy xuất dữ liệu NetScope — ví dụ Grafana, script báo cáo, hay một dashboard nội bộ. Không dùng tên người dùng / mật khẩu của bạn cho những việc này. API keys are for external systems reading NetScope data — Grafana, a report script, or an internal dashboard. Don't reuse your user account credentials for this.

Phát hành một keyIssue a key

1. Vào Cài đặt → API keys → + Key mớiSettings → API keys → + New key

   Chỉ admin mới thấy mục này.Only admins see this section.

2. Đặt tên mô tả mục đíchDescribe the purpose

   Ví dụ "Grafana dashboard - NOC" hay "Script báo cáo tháng". Tên này giúp bạn biết ai đang dùng key nào sau này.e.g. "Grafana dashboard - NOC" or "Monthly report script". This label helps you know who's using what later.

3. Chọn phạm vi quyềnPick a scope

   Read cho việc xem (99% trường hợp), Write cho tự động hóa có chỉnh sửa, Admin cho tích hợp sâu — hãy dùng mức thấp nhất đủ.Read for viewing (99% of cases), Write for automation that edits, Admin for deep integrations — always pick the lowest that works.

4. Đặt giới hạn tốc độ & hạn dùng (tùy chọn)Set rate limit & expiry (optional)

   Mặc định 60 yêu cầu/giây. Nếu là script chạy nội bộ, bạn có thể nâng lên; nếu là dashboard công khai, nên giữ nguyên hoặc giảm.60 requests/second by default. Internal scripts can go higher; public dashboards should stay put or go lower.

5. Sao chép key NGAYCopy the key NOW

   Hệ thống chỉ hiển thị key đầy đủ đúng một lần sau khi tạo. Nếu làm mất, bạn sẽ phải xóa và phát hành key mới — không có cách nào khôi phục.The full key is shown just once after creation. If you lose it, you'll have to delete it and issue a new one — no recovery path.

Sử dụng keyUsing the key

Key có dạng sfk_…. Gửi kèm mỗi request qua một trong hai cách:Keys look like sfk_…. Send them with each request in one of two ways:

# Authorization header (khuyên dùng)
curl -H "Authorization: Bearer sfk_xxxxxxxxxxxxxxxxxxxxxxxx" \
     https://netscope.example.com/api/external/v1/series/global

# Hoặc X-API-Key header
curl -H "X-API-Key: sfk_xxxxxxxxxxxxxxxxxxxxxxxx" \
     https://netscope.example.com/api/external/v1/top

Các endpoint thường dùngCommonly used endpoints

Hệ thống kèm sẵn tài liệu OpenAPI — bạn xem chi tiết tham số và phản hồi ngay trong UI, phần API → OpenAPI.An OpenAPI reference ships with the product — parameters and responses are browsable in API → OpenAPI.

Khi vượt giới hạn tốc độWhen you hit the rate limit

Server trả mã 429 kèm tiêu đề Retry-After cho biết bao nhiêu giây nên đợi. Client của bạn nên tôn trọng giá trị này thay vì thử lại ngay.The server returns HTTP 429 plus a Retry-After header telling you how many seconds to wait. Your client should honor it instead of retrying immediately.

14 · Khắc phục sự cố 14 · Troubleshooting

Dưới đây là các tình huống thường gặp và cách kiểm tra ngay trong giao diện, không cần đụng đến máy chủ.Common issues and how to check them from the UI — no server access required.

Biểu đồ trống hoặc phẳng lỳCharts are empty or flat

1. Mở trang Sensors và xem cột Packets received. Nếu luôn là 0, router chưa gửi flow — nhờ người quản trị router kiểm tra cấu hình export.Open Sensors and check the Packets received column. If it's always 0, the router isn't sending — ask the router admin to check the export config.
2. Nếu có số nhưng biểu đồ vẫn trống, vào trang IP Zones — khả năng cao dải IP của bạn chưa được thêm vào zone nào.If packets are coming in but charts stay empty, visit IP Zones — your IP range is probably missing from every zone.
3. Kiểm tra chỉ báo sức khỏe (biểu tượng ở góc phải trên). Chấm xanh = ổn; vàng / đỏ = có vấn đề, chi tiết hiển thị khi rê chuột.Check the health indicator (icon in the top-right corner). Green = healthy; yellow / red = something is wrong — hover for details.

Top talker có IP nhưng nhấn vào không ra biểu đồTop talker shows an IP but clicking gives no chart

IP đó rơi ngoài mọi node. Vào IP, dán địa chỉ vào, bạn sẽ thấy thông báo "không thuộc zone nào". Vào IP Zones để thêm node bao phủ.That IP falls outside every node. Paste it into IP — you'll see "not in any zone". Go to IP Zones and add a node that covers it.

Không nhận Telegram alertNo Telegram alerts coming through

1. Vào Cảnh báo → Kênh, nhấn Gửi thử trên kênh Telegram. Nếu fail, token hoặc chat ID sai.Go to Alerts → Channels, click Test on the Telegram channel. A failure means the token or chat ID is wrong.
2. Chắc chắn bot đã được mời vào group và có quyền gửi tin (một số group chặn bot mặc định).Make sure the bot is in the group and allowed to post (some groups block bots by default).
3. Kiểm tra Cảnh báo → Lịch sử: mỗi tin gửi thất bại có kèm lý do cụ thể — đọc dòng mới nhất sẽ thấy lỗi chính.Check Alerts → History: each failed delivery shows a reason — the most recent line usually pinpoints it.

Quy tắc không "nổ" dù lưu lượng đã vượt ngưỡngRule doesn't fire even though traffic clearly exceeds the threshold

1. Kiểm tra thời gian duy trì — nếu đặt 120s thì phải vượt ngưỡng liên tục 120s.Check the sustain time — if it's set to 120s, the threshold must be breached for 120 continuous seconds.
2. Kiểm tra quy tắc có đang bật hay không (nút bật/tắt đầu mỗi dòng).Verify the rule is enabled (toggle at the start of each row).
3. Nếu rule gắn phạm vi là 1 sensor hoặc 1 zone cụ thể, chắc chắn lưu lượng đó đang thực sự đi qua đúng phạm vi.If the rule is scoped to one sensor or zone, double-check the traffic is actually passing through that scope.
4. Đang trong giai đoạn khoảng lặng? Sau khi vừa nổ, rule im lặng trong thời gian cooldown để tránh spam.Is it in cooldown? After firing, rules stay quiet for the cooldown period to avoid spam.

API trả HTTP 429API returns HTTP 429

Bạn đang vượt giới hạn tốc độ của key đó. Giảm tần suất gọi ở phía client, hoặc vào Cài đặt → API keys để nâng rate của key (cần admin).You're exceeding the key's rate limit. Slow the client down, or have an admin raise the rate under Settings → API keys.

15 · Thuật ngữ 15 · Glossary