Is the Agent Online? What Offline Means and How to Fix It

Setup · Data Agent

Is the 대리인 online?

Test connection, Browse, Re-check and every query run on the Agent’s computer. When the Agent shows Offline, none of them can work. This page shows where to look and how to bring it back, on Windows, macOS and Linux.

약 5분 윈도우 macOS 리눅스

당신이 최종적으로 얻게 될 것

A green dot next to your Agent in 데이터 에이전트, which means it is connected and ready. The Agent is the small program on your own computer or server that reads your data; the Query Streams website can only reach your data while that program is running and online.

Check it in Data Agents

1. 오픈 데이터 에이전트

   열려 있는 데이터 에이전트 (아래에 데이터 in the top menu). Your agents are listed down the left side, one row each, with the name you gave the Agent when you installed it.

2. Look at the small dot on the Agent’s icon

   Each row has a small dot at the corner of its icon. Green means 온라인. Red, slowly pulsing, means it is not connected; the row also says Offline in red, just before the number of connectors. Hold the mouse over the dot and it reads 온라인 또는 Offline — agent is not connected.

3. Click the Agent to see how long it has been away

   Click the row. The Agent’s card opens on the right. An offline Agent has a red OFFLINE badge next to its name and a line that reads Last seen followed by a time, for example Last seen 2 hours ago. That time is usually when the computer went to sleep or was switched off, which tells you where to start. An online Agent shows 연결됨 and a time instead.

What Offline stops

Everything that has to touch your data runs on the Agent’s computer, so while it is offline:

• 테스트 연결 is greyed out. Hold the mouse over it and it says Agent is offline — start the agent to test the connection.
• Browse cannot open folders. It says Agent is offline — type the path, or start the agent to browse; you can still type a path, and it is checked when the Agent comes back.
• 다시 확인하세요 (for example the Microsoft Access engine check) cannot answer, and schema capture waits: Agent offline — capture will not run until it reconnects.
• Queries from Excel, Google Sheets, an AI assistant or the REST API do not run, and the connector’s status reads Offline: The Data Agent is currently offline.

Nothing is lost. Changes you save while it is away are kept and applied the moment it reconnects.

Agent on Windows

If the computer is asleep or switched off

This is the most common reason by far, especially on a laptop. Wake the computer or switch it on, sign in if it asks, and wait a minute or two: the dot in Data Agents turns green on its own, and you do not need to do anything in Query Streams. To stop it happening again, tell Windows not to sleep while it is plugged in:

1. Open the power settings

   On the Agent’s computer, click Start, 그 다음에 설정 (the gear icon), then System in the list on the left, then Power & battery (on a desktop computer without a battery it may just say Power).

2. Open the sleep timeouts

   클릭 Screen, sleep, & hibernate timeouts. A short list of drop-downs opens underneath.

3. Set sleep to Never when plugged in

   Find the drop-down for When plugged in, make my device sleep after (the wording varies a little between Windows versions; it is the one about sleep, not the screen) and choose 절대. There is nothing to save; the change applies straight away. The screen can still turn off; only sleep stops the Agent.

If the computer is on but the dot stays red

The Agent runs as a Windows service, a program that starts by itself in the background before anyone signs in. If that service has been stopped, the computer can be on and the Agent still offline.

1. Open the Services app

   On the Agent’s computer, click Start and type 서비스. Click the 서비스 app in the results. A window opens with a long, alphabetical list of names.

2. Find the Agent in the list

   Click any name in the list, then press Q on the keyboard to jump to the names starting with Q. Look for Query Streams Dataverse Agent. Read two columns on its row: 상태 그리고 Startup Type.

   If there is no Query Streams Dataverse Agent at all, the Agent is not installed on this computer. Install it from the Download page, following Windows에 에이전트 설치.

3. Start it

   만약에 상태 is blank, right-click Query Streams Dataverse Agent 그리고 선택하세요 Start. A small progress box appears for a few seconds, then the 상태 column reads Running.

   만약에 Startup Type says Disabled, Start is greyed out. Double-click the name instead, change Startup type 에게 Automatic클릭 Apply, then click the Start button in the same box and click 좋아요. Automatic is how the installer sets it, so the Agent starts again by itself after every restart.

4. Watch the dot turn green

   Back in 데이터 에이전트, wait a minute or two. The dot turns green and the OFFLINE badge goes away; you do not need to refresh anything.

   If the 상태 already said Running and the dot is still red after a few minutes, the service is fine but it cannot reach the internet. See the next section.

If the service is Running but the Agent is still Offline

The Agent connects out to Query Streams over the internet; nothing has to connect in to it, so no firewall rule is needed on its computer for this. But it does need to get out. On the Agent’s computer, open a web browser and go to querystreams.com.

• The page does not load: this computer is not on the internet. Check the network cable or Wi-Fi, then wait a minute or two for the dot.
• The page loads, but the Agent stays offline: something on your network, usually a company proxy or a strict firewall, is blocking the Agent’s own connection. Ask whoever looks after your network to allow outgoing secure web traffic from this computer to querystreams.com, or reply to support and we will tell them exactly what to allow.

Agent on macOS

If the Mac is asleep

A sleeping Mac takes the Agent offline. Wake it and wait a minute or two. To keep it awake while plugged in:

1. Open the sleep setting

   를 클릭합니다. Apple menu (top left), then System Settings. On a MacBook, click Battery in the list on the left (you may need to scroll down), then click Options. On an iMac, Mac mini or Mac Studio, click Energy 대신에.

2. Turn on the switch that prevents sleep

   On a MacBook turn on Prevent automatic sleeping on power adapter when the display is off. On a desktop Mac turn on Prevent automatic sleeping when the display is off. Some Macs do not offer every option; if yours has no such switch, send us a photo of the screen.

If the Mac is awake but the dot stays red

On a Mac the Agent runs as a background service named com.querystreams.agent. You check and start it from 단말기, the Mac’s window for typed commands.

1. Open Terminal

   Press Command 및 space bar together, type 단말기, and press 반품. A window opens with a line ending in % 또는 $ and a blinking cursor.

2. Check whether the Agent is running

   Type the line below and press 반품. It asks for 비밀번호: type the password you use to sign in to this Mac and press 반품. Nothing appears as you type the password; that is normal.

   Type this, then press Return

   sudo launchctl list | grep querystreams

   A line ending in com.querystreams.agent with a number at the start means the Agent is running; skip to step 4. If the line starts with a dash (–) instead of a number, or nothing comes back at all, it is not running: go to step 3.

3. Start it

   Type the line below and press 반품:

   Type this, then press Return

   sudo launchctl load /Library/LaunchDaemons/com.querystreams.agent.plist

   Usually nothing is printed. Run the command from step 2 again; it should now show a number at the start of the line. If this line says the file does not exist, the Agent is not installed: follow Install the Agent on macOS.

4. Watch the dot, or send us the log

   Wait a minute or two in 데이터 에이전트. If the dot stays red although the Agent is running, the Mac cannot reach the internet or something on the network blocks it; the checks in the Windows network section apply exactly the same. If you are stuck, send us the Agent’s log file: it is /usr/local/querystreams/agent/logs/agent-stdout.log.

Agent on Linux

If the server is up but the dot stays red

On Linux the Agent runs as the systemd service 쿼리스트림 에이전트. Run these on the Agent’s server, in a terminal or over SSH.

1. 서비스를 확인하세요

   Type this, then press Enter

   systemctl status querystreams-agent

   Read the line that starts with Active:. 활성(실행 중) in green means the Agent is running; skip to step 4. inactive (dead) means it is stopped, and failed means it stopped with an error. Press q 프롬프트를 다시 받으려면.

2. Start it, and make sure it starts after a reboot

   Type these, pressing Enter after each

   sudo systemctl start querystreams-agent
   sudo systemctl enable querystreams-agent

   Neither command prints anything when it works. Run the status command from step 1 again: it should say 활성(실행 중).

3. If it will not stay running, read the reason

   If the status shows 203/EXEC (RHEL, Rocky, Alma, Fedora), SELinux is blocking the program; relabel it and restart:

   RHEL 제품군: 203/EXEC 수정

   sudo restorecon -R /opt/querystreams/agent sudo systemctl restart querystreams-agent

   If it shows 226/NAMESPACE, the service definition is from an older Agent; run the installer again from the Download page and it is replaced. For anything else, print the last 40 log lines and send them to us:

   Type this, then press Enter

   journalctl -u querystreams-agent -n 40 --no-pager

4. Running, but still Offline

   The server cannot reach the internet, or a proxy or firewall blocks outgoing traffic. The same checks as on Windows apply: try curl -I https://querystreams.com from the server, and if it answers, ask whoever runs the network to allow outgoing secure web traffic to querystreams.com.

If the Agent is online but on an old version

The Agent keeps itself up to date, so this is rare. The Agent’s card in 데이터 에이전트 shows its version next to its name, for example v2.6.6. An Agent that has fallen behind can be online and still refuse some things: a connector type shows a chip like Agent 2.6.6+ and the message needs agent version … or newer — update the agent, then add the connection, or a toast says Agent build too old.

1. Download the current installer

   On the Agent’s computer, open the Download page and download the installer for that computer’s system, as you did the first time.

2. Run it over the top

   Run it exactly as the first time. You do not need to remove anything first. If the Agent’s setup page appears and says Previous installation found클릭 Restore previous setup: the Agent keeps its name and all its connections.

If it never came online after installing

A brand-new Agent goes online at the end of its setup, on a screen titled Agent online 함께 시작하기 button. If setup stopped at the Access key step instead, the message under the box says why:

Messages in the Portal and what they mean

관련 가이드

• Windows에 에이전트 설치
• Install the Agent on macOS
• Install the Agent on Linux
• Microsoft Access 커넥터를 설정하세요.
• 모든 가이드